100-step upgrade roadmap
Ten waves from institutional UI mastery to public launch — survivor-led trust infrastructure, BoC-style clarity, honest Gate 0 metrics.
Baseline shipped: InstSurface on 71 routes · token SSOT · WCAG 2.2 focus patterns · 0 legacy .panel in TSX.
Full step-by-step plan (vision, competitors, all 100 steps) lives in the repository runbook docs/next-level-100-steps.md.
Gate per wave: npm run verify:design-tokens && npm run build · Major milestones: verify:bundle at steps 10, 20, … 100.
10 waves × 10 steps
Wave 1 · Steps 1–10
Design system mastery
InstTabs, Modal, Toast, Progress, design-system v2
Wave 2 · Steps 11–20
Accessibility & inclusion
axe/Pa11y CI, error summaries, SR audit, Punjabi typography
Wave 3 · Steps 21–30
Path & readiness product
Save states, mirror, referral consent, PathEmbed, C3 strings
Wave 4 · Steps 31–40
Partner & funder UX
Funnel IA, MOU reader, funder pack, attribution, presenter mode
Wave 5 · Steps 41–50
Trust & governance
Trust nav, Gate 0 honest UI, AI scope, policy versions
Wave 6 · Steps 51–60
i18n & Punjabi
Locale switcher, C3 50/50, PA hub, hreflang
Wave 7 · Steps 61–70
Performance & tech
Lighthouse CI, fonts, PWA, security headers, CWV
Wave 8 · Steps 71–80
Content & SEO
COPY SSOT, JSON-LD, guild templates, sitemap
Wave 9 · Steps 81–90
Admin & observability
InstTable queues, Sentry, portal/training UX
Wave 10 · Steps 91–100
Growth gates & launch
Honest impact, deploy, public launch checklist
Recommended order
- Waves 1–2 — design primitives + a11y (funder/board credibility)
- Waves 3–4 — path + partners (Gate 0 path)
- Wave 5 — trust surfacing (governance moat)
- Waves 6–7 — Punjabi + performance (BC newcomer reach)
- Waves 8–10 — SEO, admin, honest growth to launch