Skip to content
halfguruPublic

About

๐Ÿ A Canadian retirement planner for RRSP, TFSA, and CPP planning

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

Retire, Eh? ๐Ÿ

CI Deploy License: MIT

Plan your Canadian retirement, eh?

A household-first retirement planner for Canadians. Build an RRSP, TFSA, and CPP strategy with conservative projections and transparent math. Everything runs locally in your browser.

Screenshot

Live Demo

Features

  • Household-first dashboard with combined progress across people
  • Canadian-focused: RRSP, TFSA, and CPP planning built in
  • Visual projections for portfolio growth over time
  • Goal tracking against your retirement income target
  • Private by default: all calculations run in-browser
  • Fast & lightweight: pure TypeScript client-side engine with zero loading delay

Quick Start

git clone https://github.com/halfguru/retire-eh.git
cd retire-eh
npm install
npm run dev

Open http://localhost:5173 to view the app.

Tech Stack

Layer Technology
Frontend React + TypeScript + Tailwind CSS
Charts Recharts
Calculations Pure TypeScript Calculation Engine

All financial logic runs client-side in pure TypeScript: deterministic, testable, instant, and privacy-preserving.

Development

npm run dev        # Start dev server
npm run build      # Production build
npm run typecheck  # TypeScript check
npm run lint       # ESLint
npm test           # Vitest unit tests

AI-Assisted Development

See AGENTS.md for build commands and conventions.

Design Philosophy

  • Conservative assumptions: realistic projections over optimistic ones
  • Explicit explanations: the math is always visible
  • Household-first approach: savings evaluated jointly across partners

One household balance sheet, multiple tax wrappers.

Retirement success is a household outcome. Savings get evaluated jointly regardless of who contributes, with strategic allocation between RRSP and TFSA based on marginal tax rates.

What This Doesn't Do

  • Bank account linking or real-time market data
  • FIRE or early-retirement evangelism
  • Non-Canadian retirement accounts (401k, IRA, etc.)

License

MIT. See LICENSE for details.

About

๐Ÿ A Canadian retirement planner for RRSP, TFSA, and CPP planning

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

⌂ ๆข็ฝ‘ๅ€