FirePath is a launch-ready MVP for deterministic FIRE (Financial Independence / Retire Early) planning.
It helps users:
- build a structured FIRE Plan,
- review projected timeline outcomes,
- compare built-in scenario tradeoffs,
- and share a client-ready report via browser Print / Save as PDF.
FirePath provides an end-to-end planning flow across five routes:
/— product overview, quick-start actions, and MVP status/plan— guided multi-step FIRE Plan questionnaire/results— deterministic projection output + explainability/scenarios— deterministic scenario comparison and delta analysis/report— polished report surface + export actions
The app is intentionally backend-free in v1 so it runs locally and demos reliably with only frontend dependencies.
- Start Plan from Home or Header CTA.
- Complete the 6-step plan flow on
/plan. - Review deterministic outputs on
/results. - Stress-test assumptions on
/scenarios. - Share a polished report from
/reportusing Print / Save as PDF.
If required inputs are missing, the app shows intentional fallback messaging and can use sample data to keep demos moving.
- Next.js 14 (App Router)
- TypeScript
- Tailwind CSS
- React Hook Form + Zod
- Zustand (client state)
- Recharts
- App-wide layout, navigation, metadata groundwork, and launch-oriented branding
- Deterministic FIRE calculation engine (no Monte Carlo in v1)
- Plan builder with validation, step navigation, save/review flow
- Results page with milestones, timeline chart, assumptions, and strategy guidance
- Scenario comparison with editable assumptions and plain-English deltas
- Report composition pipeline with export actions and structured sections
- Launch polish states:
- empty states,
- loading/skeleton scaffolding,
- fallback/sample-data messaging,
- app-level
not-foundand error UI
FirePath v1 is a deterministic planning tool. It applies fixed assumptions and rule-based calculations to produce consistent outputs for the same inputs.
Included now:
- fixed-return style projection
- inflation + withdrawal assumptions
- scenario deltas across predefined adjustment dimensions
Deferred intentionally:
- Monte Carlo probability modeling
- tax-location / withdrawal sequencing optimization
- account-level contribution constraints and jurisdiction-specific logic
For launch demos, FirePath can gracefully continue when user input is incomplete:
- Results/scenarios/report can use sample baseline data when needed.
- The UI explicitly tells users when sample/fallback data is being used.
- This avoids blank screens during first-run demos while preserving transparency.
- Node.js 18+
- npm 9+
npm install
npm run devOpen: http://localhost:3000
npm run build
npm run start- No backend services are required.
- No auth/database setup is required.
- No external AI API keys are required.
- Current export flow is browser-native Print / Save as PDF.
- Install dependencies:
npm install - Validate local dev:
npm run dev - Validate production build:
npm run build - Validate production runtime:
npm run start - Confirm route flow:
/→/plan→/results→/scenarios→/report - Confirm fallback messaging appears when plan data is incomplete
- Confirm report export opens browser print dialog
- End-to-end deterministic planning experience
- Scenario comparison workflow
- Client-ready report view + print/PDF path
- Polished navigation, metadata, and launch-ready fallback/error states
- Advanced stochastic simulation (Monte Carlo)
- Deeper tax and withdrawal logic
- Rich export/sharing workflows beyond browser print
- Optional backend persistence and collaboration capabilities
- Add unit tests for deterministic engine and scenario delta calculations.
- Add integration tests for core route flow and fallback states.
- Add richer chart accessibility and keyboard/ARIA refinements.
- Add CI checks for typecheck/lint/build.
- Add deployment target config (e.g., Vercel) and release workflow notes.