Route Map

Public routes

/: public marketing surface
/docs: public builder docs when the docs module is enabled; disabled-state surface when it is off
/blog: public editorial index plus /blog/<slug> article routes for published posts
/sign-in: branded starter-owned Clerk sign-in surface
/sign-up: pricing redirect; account creation still starts from checkout

Purchase and recovery routes

/checkout/success: post-checkout validation, server-fetched initial product-access state, then live product-access polling
/checkout/cancel: checkout cancel return
/session-tasks/reset-password: Clerk password-reset task inside the shared identity shell
/sso-callback: OAuth callback completion route inside the shared identity shell
/start: canonical first-time workspace landing after checkout
/mission: restored post-review bonus-library home that stays locked until Execute / Ship is unlocked

Protected product routes

/start: packet-first orientation and framing
/product: stable stage-entry route that redirects to the current Product packet page
/product/[stepId]: canonical Product packet pages such as /product/foundation, /product/problem, /product/outcome, and /product/scope
/design: stable stage-entry route that redirects to the current Design packet page
/design/[stepId]: canonical Design packet pages such as /design/flow, /design/references, /design/direction, and /design/system
/marketing: stable stage-entry route that redirects to the current Marketing packet page
/marketing/[stepId]: canonical Marketing packet pages such as /marketing/operating-system
/build-plan: stable stage-entry route that redirects to the current Build Plan packet page
/build-plan/[stepId]: canonical Build Plan packet pages such as /build-plan/delivery, /build-plan/plan, and /build-plan/validation
/review: final readiness and repo-download surface
/execute: optional post-review bonus bridge that unlocks from /review, offers Continue in Build to lesson 3.1, offers Start from the beginning to lesson 1.1, and redirects repeat bonus visitors to /mission
/settings: protected account and product settings
/mission: bonus-library home once the post-review bonus is unlocked; it defaults to Build but keeps the natural Product -> Design -> Build -> Ship block order in the top rail
/lesson/[lessonKey]: restored post-review bonus lesson route; renders locked messaging before unlock and video-first bonus lessons after unlock
/artifacts: legacy compatibility route that now forwards into /review

Repeat-routing note: after a customer opens any restored bonus lesson, /execute stops acting like the first-entry bridge and sends them to /mission instead. QA should verify both the first unlocked bridge state and the repeat-visit redirect state.

These protected routes render behind app/(workspace)/layout.tsx, starting from server-fetched access or packet-workspace data before the browser resumes live Convex subscriptions. The stage-root URLs remain the shared app contract, but the packet form itself now lives on the nested packet pages.

Why this matters

If you use the wrong route language in prompts or docs, the agent can implement the right idea against the wrong surface.