Your org chart, mapped. Search. Navigate. Found.
OrgAtlas is a free, open-source municipal org chart and routing engine. It combines a 75-person synthetic org, deterministic request routing, full position descriptions, and 55 practice scenarios — all in a single TypeScript service you can run locally or host yourself.
Free & open: Every person, contact, request, policy boundary, and org record is synthetic. OrgAtlas is a free, open-source starter kit — not a live government system or commercial SaaS.
Live demonstration: orgatlas.cityaipolicy.org
See DEPLOYMENT.md for the live architecture, API surface, operating workflow, validation baseline, and safety boundaries.
- Deterministic routing — plain-language requests route to responsible roles via a transparent, inspectable algorithm (
route-v1), not AI - 75-person synthetic org — 1 Director, 1 Assistant Director/COO, 6 Senior Managers, 12 Division Heads, 55 Supervisors across 12 divisions
- 55 practice scenarios — one per Supervisor, with intake checklists, authority boundaries, and continuity backups
- Full position descriptions — duties, decision rights, approval limits, escalation triggers, continuity contacts
- Interactive org chart — visual + accessible tree, synchronized selection
- Premium Dusk Fieldcraft UI — dark theme, accessible, responsive, print-ready, opt-in motion/ambience
- Zero AI at runtime — deterministic
route-v1algorithm, zero LLM calls at runtime
# Requirements: Node 22+, npm 10+
git clone https://github.com/agelessextra-design/OrgAtlas.git
cd OrgAtlas
npm ci
npm run verify # runs all tests, typecheck, lint, build
npm run build
npm start # http://127.0.0.1:3000- Starter kit for municipal admin tools — fork and replace the dataset
- Learning tool — study deterministic routing, org graph traversal, accessible UI patterns
- Self-hosted — run on your infra, zero external dependencies
- Extensible — swap the dataset, add endpoints, extend the UI
| Gate | Status |
|---|---|
| Data validation | ✅ 75 people, 12 divisions, 55 scenarios |
| Unit/API/domain tests | ✅ 54/54 passing |
| TypeScript strict | ✅ 0 errors |
| ESLint (max-warnings=0) | ✅ 0 errors |
| Production build | ✅ 272 KB raw / 84 KB gzipped |
| Bundle budget | ✅ 272 KB < 350 KB raw, 84 KB < 220 KB gzipped |
- Routing = deterministic lexical scoring (
route-v1), fully explainable - Search = Unicode-aware tokenization + weighted keyword matching
- Org graph = pure graph traversal (reports-to, divisions, supervisors)
- Scenarios = 55 human-authored practice cases in
data/scenarios.json - Zero LLM calls at runtime — the OpenRouter key is only for local experimentation
npm run verify # data validation, tests, typecheck, lint, build
npm run test # 54 unit/integration tests
npm run test:e2e # 88 Playwright checks across desktop and mobile browser projects
npm run build # production build
npm run start # API + SPA on http://127.0.0.1:3000OrgAtlas deploys as one Cloudflare Worker with static assets and the deterministic API on the same origin. The checked-in wrangler.jsonc binds the SPA assets, sends /api/* through the Worker, and attaches orgatlas.cityaipolicy.org as a custom domain.
npm ci
npm run verify
npm run deploy:check
# Set CLOUDFLARE_API_TOKEN securely in your environment, then:
npm run deploy:previewThe deployment token needs Workers Scripts edit access at the account level, plus DNS, Workers Routes, and Zone Settings edit access scoped to the intended zone. Never commit or paste the token into repository files.
MIT — see LICENSE. Free to use, modify, distribute.
See CONTRIBUTING.md — conventional commits, PRs welcome.