MoneyTracker

MoneyTracker is a full-stack personal finance manager built as a modern learning & portfolio project.
It helps you track accounts, transactions, categories, merchants, and receipts — with a clean architecture and AI-powered extensions.

---

✨ Features

• 📊 Manage accounts (cash, bank, credit, crypto, etc.)
• 🧾 Record transactions (income, expenses, transfers)
• 🗂️ Organize categories and merchants
• 📷 Attach receipts (AI-ready for OCR & auto-categorization)
• 🔒 Secure authentication (with future 2FA support)
• 🚀 Built with a modular monorepo architecture

---

🛠 Tech Stack

Frontend – apps/web

• React + Vite
• shadcn/ui + TailwindCSS
• React Router v7
• TanStack Query + Zustand + Zod

Backend – apps/api

• Fastify (Node.js)
• Prisma ORM
• PostgreSQL
• Redis (planned)

Receipts Service – apps/receipts

• Python microservice
• OCR & AI auto-categorization (future)

Infrastructure

• pnpm workspaces (monorepo)
• Docker (planned)
• GitHub Actions CI/CD (planned)

---

📦 Monorepo Structure

apps/
  web/        # React frontend
  api/        # Fastify + Prisma backend
  receipts/   # Python microservice (OCR/AI)
packages/
  db/         # Prisma schema & client
infra/        # (future) Docker, deploy, CI configs

---

🚀 Getting Started

1. Clone the repo

git clone git@github.com:albelko/moneytracker.git
cd moneytracker

2. Install dependencies

pnpm install

3. Setup database

cp .env.example .env
pnpm --filter @moneytracker/db prisma migrate dev

4. Run apps

Frontend:

pnpm --filter @moneytracker/web dev

Backend:

pnpm --filter @moneytracker/api dev

---

📝 License

MIT – feel free to use and modify.

---

📌 Roadmap

• User authentication & 2FA
• Receipt OCR + auto-categorization
• Reports & analytics dashboards
• Dockerized local dev setup
• Deployment guides (Vercel / Fly.io / Railway)

---

🤝 Contributing

This project is mainly for personal use & portfolio, but suggestions and ideas are welcome! Open an issue or PR to discuss improvements.