Complied — Design Authority
How the app looks. Created 2026-07-20 to end fragmentation across old sketch folders. Tokens still live in src/index.css (--panel/--canvas/--ink). Appearance is class-based (.dark / .eco via AppearanceSwitcher), not the old app's data-mode attribute. The .planning/phases/… sketch tree no longer exists in this repo — treat this file and src/index.css as the surviving contract, not those paths.
Pixel conformance of individual pages was never visually verified (Phase 54 graded "uses the kit," not "matches the sketch"). Do not treat the old per-page table as live status.
1. The locked design system — "Command"
Decided in the 2026-07-08 design quiz (DQ1–DQ6), implemented as Command (Phase 48).
- Color: near-black ink
#12151a· warm-white canvas#fbfbfa· green#00bf63= signal only (status dots, live pings, active tab/rail — never a button fill). Hairline rules, not boxes; no card-in-card. Dark/eco palettes are in the same file. - Tag map (6 colors, max 3 families/row): red = violation/overdue · green = positive/action/live · blue/gray = service type · amber = deadline warning · purple/gray = lab · gray = neutral/closed. Pills for status / violation-reason / HPD-order (max 2/row); dots+text for secondary; plain text for names/addresses.
- Buttons: black primary (
#111316, 10px radius) · quiet gray-text secondary. Green is never a button. - Sidebar: grouped rail (Work / Records / Money / Tools + account). Several items are unlinked stubs (Dashboard, Tasks, Sales, Deadlines, Reports, Billing, Communications, Compliance/Lab, Notifications, Admin, Knowledge). Live destinations: Projects, Field jobs, Buildings, Clients, Violations, Complied Map. Settings is on the avatar menu.
- Type: Space Grotesk (headings/display) + Inter (body) + DM Mono. Corners 10–12px containers / 9–10px pills.
2. Pages that exist in the promoted app
| Page | Route | Notes |
|---|---|---|
| Violations explorer | /violations | Rebuilt (Rung 6 follow-up). Not "being rebuilt." |
| Complied Map | /map | Citywide viewport map; needs ingested public_events |
| Projects list / new / detail | /projects, /projects/new, /projects/:id | Detail is Decide / Work / File / Money |
| Field jobs | /field, /field/:inspectionId | Queue + inspection wizard |
| Buildings / clients | /buildings, /clients | Plus /:id detail |
| Settings | /settings | Licenses, rate cards, branding — avatar menu, not sidebar |
| Portal | /portal/* | Read-only client surface |
| Landing | / | Public Mapbox hero — not the authenticated map |
Do not look for /operations, /dashboard, /obligations in src/routes.tsx — those are archive routes.
3. Violations page — locked spec (owner-approved 2026-07-20)
The intent below still stands as the design target. The promoted /violations explorer is a rebuilt list, not a claim that every subsection shipped.
3.1 Structure — three tiers, role-filtered
- Category (top strip, oversight): the mile-wide compliance picture. Lead paint = "Yours" (fulfilled); the rest = "Monitor" (real data, not yet actionable until accuracy-verified).
- Subcategory (pills, for the active category): Lead → Hazard · Turnover · Records (+ LL31).
- Order (leaf): drill a subcategory to specific orders (616/617/624 · 621/622/623/625 · 618/619/620).
3.2 Category strip — data reality (snapshot 2026-07-20, old app)
Counts below are a 2026-07-20 snapshot of then-loaded public_events, not today's local/prod load. Trust ingest docs for current coverage.
| Category | Source | Ship as |
|---|---|---|
| Lead paint | HPD | Live (Yours) — default selected |
| Sanitation | DSNY (OATH) | Live · Monitor |
| Fire safety | FDNY (OATH) | Live · Monitor |
| Environmental | ECB | Live · Monitor |
| Health | DOHMH (OATH) | Live · Monitor |
| Construction | DOB | Live · Monitor |
| Liens | DOF | Live · Monitor |
| Pests / Mold / Heat | HPD housing | Preview cards in the old app; recategorize migration 20260723090000 is archive-era |
3.3 Columns
- Lean default (always): Order # · Unit · What & where · detailed Status · Certify-by.
- Column chooser (off by default): HPD violation # · Issue date · Status date · Correct-by date · Violation class · Penalty · Assigned to.
- Badges, not columns: Rent-impairing; Class (near-constant "C" for lead → toggle-only).
- Grouped by building (client in the group header).
3.4 Chrome
- Quiet search, Open/Overdue/All, click-to-open rows, load-more. No scattered per-row action buttons.
4. Rules for this doc
- Build UI to §1 — never freehand-redesign the token system.
- Owner verifies pixels (executor can't log in). "Monitor" = real data shown, not yet authoritative.
- For whether a page exists and works, use
LIFECYCLE_ASSESSMENT.mdanddomain/OVERVIEW.md, not this file's old conformance table.