settings — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited settings (Hook) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
A free, open-source directory helping people discover who's working on the issues that matter most — in every community across America.
[!IMPORTANT] Atlas's first principle is [Experience First](./docs/experience-first.md): the end-user experience is the product and the reason this nonprofit exists. Anyone can hold this data; the experience of finding people and trusting what you see is the whole point.
Across the country, thousands of organizations and individuals are working on housing, labor, climate, democracy, justice, and more. But finding them isn't easy. Information is scattered, outdated, or buried in search results.
Atlas changes that. It's a searchable, public directory powered by an AI-driven discovery engine that continuously finds and organizes information about the people and groups doing meaningful work in communities everywhere. Every entry is traced back to public sources, so you can see exactly where the information comes from.
This is a nonprofit, open-source project. To learn more about our mission and goals, see the Product Vision.
Whether you're a developer, researcher, organizer, or just curious — welcome. Here's how to get involved:
Prerequisites: Python 3.12+, Node.js 24+, and Make. See full prerequisites.
cd atlas
make setup
pnpm dev| Service | URL |
|---|---|
| Frontend | http://app.localhost:1355 |
| API | http://api.localhost:1355 |
| API Docs | http://api.localhost:1355/docs |
[!TIP] We use Portless to manage local services. It eliminates port conflicts by providing stable, named URLs for each service. Ensure your local environment variables (e.g., in app/.env.local) are updated to point to these URLs.Contributor documentation still lives in docs/, and the new Mintlify docs project lives in mintlify/:
| Section | Description |
|---|---|
| Getting Started | Installation, setup, and project orientation |
| Architecture | System design, data model, and pipeline |
| Development | Workflow, building features, and testing |
| Standards | Code style, commit conventions, and API design |
| Deployment | Production deployment and release process |
| Design | Product vision and system design documents |
For the Mintlify API docs:
mintlify/docs.jsonmintlify/api-reference/pnpm docs:validateAtlas exposes a Model Context Protocol server at https://atlas.rebuildingus.org/mcp so AI assistants can search the catalog and pull place-level civic data through natural language. The server implements the 2025-11-25 MCP authorization spec end-to-end (RFC 8414 AS metadata, RFC 9728 protected-resource metadata, RFC 8707 resource indicators, PKCE S256, Client ID Metadata Documents). A future release will publish the server to the MCP Registry under the org.rebuildingus.atlas/atlas namespace; until then, point clients at the URL directly.
Setup walkthroughs, troubleshooting, and the full tool reference live in the Mintlify docs:
Start with the Getting Started guide, then follow the Development Workflow for day-to-day practices. All commits must follow the Conventional Commits format, enforced automatically by git hooks.
This project is licensed under the MIT License.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.