From 2cf3ff4d0b36d0157436f7791f5f84fb1a0dadc1 Mon Sep 17 00:00:00 2001 From: Ashwin Kumar Date: Mon, 16 Mar 2026 22:23:58 +0100 Subject: [PATCH] chore: bootstrap solid frontend repo with migration plan --- .gitignore | 6 ++++++ README.md | 8 ++++++++ docs/MIGRATION_MASTER_PLAN.md | 21 +++++++++++++++++++++ 3 files changed, 35 insertions(+) create mode 100644 .gitignore create mode 100644 README.md create mode 100644 docs/MIGRATION_MASTER_PLAN.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..0b5755c --- /dev/null +++ b/.gitignore @@ -0,0 +1,6 @@ +node_modules +dist +.output +.env +.env.* +.DS_Store diff --git a/README.md b/README.md new file mode 100644 index 0000000..d694ec1 --- /dev/null +++ b/README.md @@ -0,0 +1,8 @@ +# NXTGAUGE Frontend Solid + +SolidStart migration target for `nxtgauge-frontendwebsite`. + +## Principle +Reproduce the same user-facing behavior and runtime-config driven flows without changing product logic. + +See `docs/MIGRATION_MASTER_PLAN.md` for the staged plan. diff --git a/docs/MIGRATION_MASTER_PLAN.md b/docs/MIGRATION_MASTER_PLAN.md new file mode 100644 index 0000000..021bc39 --- /dev/null +++ b/docs/MIGRATION_MASTER_PLAN.md @@ -0,0 +1,21 @@ +# 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.