Blue North Docs
Blue North is an open-source field organizing platform for campaigns that need voter lists, turf cutting, canvassing operations, phone banks, field offices, and campaign intelligence in one place.
This documentation site is generated from the markdown files in the monorepo docs/ directory. Keep product behavior, implementation notes, and operational runbooks here so future contributors can understand why the app works the way it does.
Start here
- Application Architecture — domain boundaries, app structure, and review checklist for new code.
- File Structure Guide — where new routes, features, components, and shared modules should live.
- Data Access Guide — how production data should flow through Supabase-backed repositories.
- Database Design — planned multi-campaign Postgres/Supabase schema, RLS, backups, and admin model.
- Field Office Operations — how field offices, blockwalk launches, and phone banks work.
Current product areas
| Area | What it covers |
|---|---|
| Dashboard | Campaign KPIs, live activity, and overview maps |
| Voter file | Searchable voter records, lists, and saved universes |
| Turf | Map-based regions, turfs, and walkable canvassing packets |
| Canvassing operations | Canvassers, field offices, blockwalk launches, phone banks, supplies, schedules, and outcomes |
| Network knowledge | Precinct chairs, local leaders, unions, faith leaders, clubs, and other organizing contacts |
| Admin / production readiness | Multi-campaign access, Supabase data model, RLS, backups, and support tooling |
Documentation standards
When adding or changing product behavior:
- Update the relevant doc in
docs/during the same PR. - Prefer source-of-truth docs over scattered notes in issue comments.
- Include validation commands when a feature has a known smoke-test path.
- Make sandbox/demo assumptions explicit so production behavior is not confused with localStorage prototypes.
Local docs development
cd docs-site
npm install
npm run start
The docs app reads markdown from ../docs, so edits to product docs show up in the Docusaurus site without copying files.