A privacy-first suite of FIRE (Financial Independence Retire Early) planning tools. Financial data is stored locally by default; optional integrations (Yahoo Finance prices, LLM categorization) contact external services only when explicitly enabled.
This software is for educational and planning purposes only — not financial, legal, or tax advice. Market data from Yahoo Finance is indicative only, may be delayed or inaccurate, and the endpoint is unofficial. Always verify with your broker. See rate-limit details in Settings → Market Data.
| Feature | Description |
|---|---|
| 🧮 FIRE Calculator | Net-worth projections based on savings rate, expenses, and expected returns. Supports Standard, Lean, Fat, Barista, and Coast FIRE variants — see docs/user/fire-calculator.md. |
| ↩️ Reverse FIRE Calculator | Compute the monthly savings needed to retire by a target age — docs |
| 🎲 Monte Carlo Simulations | Probabilistic success analysis with volatility and black-swan modelling |
| 📈 Investment Growth Calculator | Project portfolio end value over time with contributions, expected returns, inflation, and savings-rate feedback |
| 📉 Withdrawal Rate Simulator | Trinity-style portfolio longevity test across withdrawal rates with a live slider |
| 📊 Asset Allocation Manager | Portfolio tracking with rebalancing recommendations |
| 🍩 Portfolio Breakdown (experimental) | Multi-dimensional view (sector, region, currency, provider) — details |
| 📄 PDF Import (experimental) | Parse receipts/statements in-browser; optional LLM categorization — details |
| 💵 DCA Helper | Dollar-cost averaging planning |
| 💳 Debt Payoff Calculator | Snowball/avalanche strategies, fixed-budget or fixed-timeline modes, repayment timeline chart |
| 💰 Cashflow Tracker | Income/expense categorization, budgets, 50/30/20 analysis |
| 📈 Net Worth Tracker | Monthly snapshots of assets, cash, pensions with historical charts |
| 📥 CSV Export / Import | Full data backup and restore |
| 🌍 Multi-language | English, Italian, French, German, Spanish — change in Settings |
| ℹ️ Build Info | Version, commit hash, dependency versions in Settings → About |
git clone https://github.com/mbianchidev/fire-tools.git && cd fire-tools
npm install
npm run dev # → http://localhost:5173To preview the full site (landing page + docs + OpenAPI viewer):
npm run dev:all # mirrors GitHub Pages layoutTo run the Electron desktop app against the local backend (boots
server/ + Vite + Electron in one shot):
npm install --prefix server # first time only
npm run electron:dev:full # backend on :8787 + Electron rendererUse npm run electron:dev if you only want Vite + Electron without the backend.
| Mode | Storage | How to run | Details |
|---|---|---|---|
| Browser | AES-256-encrypted cookies + localStorage | npm run dev or hosted demo |
Client-side only |
| Docker | SQLite (volume-backed) | docker compose up -d → localhost:8080 |
docs/deployment/ |
| Electron | SQLite at OS userData path | npm run electron:dist |
electron/README.md |
| Mobile | Via backend API | Separate Flutter repo | docs/mobile/ |
| Layer | Technologies |
|---|---|
| Frontend | React 19 · TypeScript · Vite · React Router · Recharts · react-i18next · crypto-js |
| Backend | Node.js · Express 4 · better-sqlite3 · Zod · TypeScript (ESM) |
| Desktop | Electron (hardened, contextIsolation + sandbox) · electron-builder · electron-updater |
| API | OpenAPI 3.0.3 — docs/api/openapi.yaml |
| Database | SQLite (first-class) · PostgreSQL-compatible — docs/database/schema.sql |
- Local-only by default — desktop uses SQLite; browser uses encrypted cookies. Nothing leaves your device unless you opt in.
- AES-256 browser encryption — cookie values encrypted before storage
- Optional passphrase DB encryption (desktop) — docs/security/passphrase.md
- PII-gated logs — financial data excluded unless explicitly enabled — docs/engineering/logging.md
Full policy: SECURITY.md
| Topic | Link |
|---|---|
| OpenAPI contract | docs/api/ |
| Database schema | docs/database/ |
| Deployment guide | docs/deployment/ |
| User guides | docs/user/ |
| Engineering docs | docs/engineering/ |
| Desktop app | electron/README.md |
| Backend server | server/README.md |
| Mobile app plan | docs/mobile/ |
| PDF import | docs/pdf-import.md |
| Security policy | SECURITY.md |
| Contributing | CONTRIBUTING.md |
| AI agent instructions | AGENTS.md |
See CONTRIBUTING.md. Check open issues, fork, branch, and submit a PR.
You can also report bugs from the app: Settings → Support & Feedback.
