nxtgauge-frontend-solid/docs/MIGRATION_MASTER_PLAN.md

Frontend Solid Migration Master Plan

Goal

Migrate public/product frontend from Next.js to SolidStart with parity-first execution.

Must-Preserve Flows

1. Auth and session handling.
2. Runtime dashboard template loading.
3. Role intent selection and role switch behavior.
4. Runtime onboarding renderer (no hardcoded fallback).
5. Upload validation semantics.
6. Verification and post-submission status flow.

Stage Sequence

1. Build SolidStart shell with routing and layout parity.
2. Port API proxy layer equivalents for current backend endpoints.
3. Port runtime-config and dashboard-template client logic.
4. Port onboarding renderer and all role-specific behavior.
5. Port dashboard pages module-by-module.
6. Run parity suite and resolve drift.
7. Cut over after acceptance.