RepoWrangler documentation
RepoWrangler is an open-source, single-tenant repository estate command center: it discovers every repository across your GitHub (and GitLab) estate, tracks branch/PR/pipeline/security/budget health, and surfaces what needs attention — read-only, no write actions against your providers. It is platform-neutral (ADR-013): the same product runs on Cloudflare, a self-hosted container, Azure, or Kubernetes, and every deployment starts in demo mode (mock data, no secrets) so you can see the whole app before wiring anything up.
Start here
| I want to… | Read |
|---|---|
| See it running in one command | Getting started |
| Choose where to deploy it | Deployment guide + capability matrix |
| Connect my GitHub estate | Providers → GitHub App |
| Connect GitLab | Providers → GitLab |
| Sign in with Microsoft Entra ID | Providers → Entra ID |
| Configure every setting | Configuration reference |
| Understand how it's built | Architecture |
| Call the API | API reference |
| Run it in production | Operations & runbooks |
| Understand the security model | Security |
| Contribute or extend it | Developer guide |
| Fix a problem | Troubleshooting |
Documentation map
- Getting started — getting-started.md: the fastest path to a running instance (demo, then real).
- Deployment — deployment.md: pick a target (Cloudflare, Docker, Azure Container Apps, Kubernetes, decoupled SPA), with a capability matrix and a decision flowchart. Per-target recipes live under
deploy/. - Configuration — configuration.md: every environment variable / binding, what sets it per target, and which are secret.
- Providers — how to connect each data/identity provider: GitHub App, GitLab, Entra ID sign-in.
- Architecture — architecture.md: C4-style context / container / component views, the storage and auth seams, and the ADR index.
- Reference — API, service catalog, capability matrix, the database schema (
migrations/), and the design pack. - Operations — operations.md: sync, backup/restore, disaster recovery, upgrades, migrations, plus the runbooks under
operations/. - Security — security.md: trust boundaries, secret storage per target, read-only guarantee, webhook verification, vulnerability reporting.
- Developer — developer.md: monorepo layout, how to add a provider / storage adapter / auth provider, migrations, releases, ADRs.
- Decisions — ADR index: the architectural decision records.
Project docs
Governance and contribution docs live at the repository root: README, ROADMAP, CHANGELOG, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT, GOVERNANCE, SUPPORT.