Open Finance Planner

📊 Open-source, privacy-first personal finance planner.
Works offline-first (IndexedDB), syncs with a FastAPI backend, and runs as a Progressive Web App (PWA).

• ✅ Desktop + Mobile (responsive)
• ✅ Offline-first (IndexedDB )
• ✅ No ads, no trackers
• ✅ Deployable on Vercel

---

🚀 Features

• Transactions: Add/edit/delete with category, tags, description.
• Budgets: Monthly category budgets with progress tracking.
• Debts: Track debts, principal, interest, and payoff projections.
• Reports: Income vs Expenses, Category breakdown, Cashflow timeline.
• Export: CSV / JSON download of transactions.
• Offline-first: Store in IndexedDB → sync queue → auto-sync when online.

📦 Installation & Setup

1. Clone repo

git clone https://github.com/your-username/open-finance-planner.git
cd open-finance-planner

2. Install dependencies

npm i

3. Run locally

npm run dev

---

🤝 Contributing

We ❤️ open-source!

• Fork & clone the repo.
• Create a feature branch:

  git checkout -b feature/new-idea

• Commit changes & push:

  git commit -m "Added X feature"
  git push origin feature/new-idea

• Open a Pull Request 🎉

Check CONTRIBUTING.md for style guide & PR rules.

---

✅ Success Criteria

• App runs on desktop & mobile browsers.
• Works offline (transactions saved).
• Frontend deployed on Vercel.
• Contributors can run locally in <10 mins.

---

🔥 You’re ready to manage money the open-source way.