FinTrack

Personal finance command center — built by a developer, for a developer.

What It Does

Single-user finance dashboard for tracking income, expenses, budgets, exchange rates, and freelance invoices. Designed for someone with multiple income streams, multi-currency transactions, and zero patience for bloated accounting software.

Features

• Quick transaction entry — amount, category, done in seconds
• Multi-currency support — JOD base with 165+ currencies, live exchange rates
• Dashboard — balance overview, cashflow charts, budget progress, spending breakdown
• Transaction management — full CRUD, advanced filters, bulk actions, URL-synced state
• Exchange rates — live rates table, historical charts, currency converter
• Budgets — category-based spending limits with progress tracking
• Analytics — spending trends, freelance income tracking, net worth over time
• Invoicing — create, send, and track freelance invoices
• Recurring transactions & bill payments — scheduled jobs auto-generate them
• Settings — categories, accounts, security, data import/export, appearance

Tech Stack

Backend

• Laravel 13 — PHP 8.3+, Sanctum auth (cookie-based SPA)
• MySQL 8.4 — primary database
• Redis 7 — sessions, cache, queue
• Meilisearch — full-text search

Frontend

• Next.js 16 — React 19, Turbopack, App Router
• Bun 1.3.14 — package manager + runtime
• Tailwind CSS 4.2 — OKLch color palette, dark mode first
• shadcn/ui (base-ui) — component library
• TanStack Query — data fetching + cache
• React Hook Form + Zod — form handling + validation
• Recharts — charts and data visualization

Getting Started

Prerequisites

• Docker Desktop (or Docker Engine + Compose)

Quick Start (Docker)

cp .env.example .env
make setup

That's it. Builds containers, generates app key, runs migrations + seeds.

Services:

Host ports for MySQL (3307) and Redis (6380) are offset from the defaults so they don't collide with Herd or other local services. Override via FORWARD_DB_PORT / FORWARD_REDIS_PORT in .env. All forwarded ports are bound to 127.0.0.1.

Default Login

After make setup runs the seeders, sign in with:

Change the password from Settings → Security immediately after first login.

Seed the Database

make setup seeds automatically. To re-seed (or seed an existing database) without rebuilding everything:

make seed                                          # Run all seeders
make fresh                                         # Drop, re-migrate, re-seed (destroys data)
make shell                                         # Shell into the backend container
  php artisan db:seed --class=CategorySeeder       # Run a single seeder
  php artisan db:seed --class=SampleTransactionSeeder

Seeders live in backend/database/seeders: UserSeeder (default login), CurrencySeeder, CategorySeeder, AccountSeeder, PaymentMethodSeeder, TagSeeder, SettingsSeeder, ExchangeRateSeeder, ClientSeeder, InvoiceSeeder, BudgetSeeder, SavingsGoalSeeder, BillSeeder, SampleTransactionSeeder.

Useful Commands

make up          # Start all containers
make down        # Stop all containers
make rebuild     # Rebuild + restart
make logs        # Tail all logs
make shell       # Shell into backend
make migrate     # Run migrations
make fresh       # Drop, re-migrate, re-seed
make test        # Run tests
make help        # List all commands

Frontend Dev (without Docker)

cd frontend
bun install
bun run dev

Project Structure

fintrack/
├── docker-compose.yml   # Full stack orchestration (5 services)
├── Makefile             # Dev commands
├── backend/             # Laravel 13 API
│   ├── app/
│   │   ├── Enums/        # PHP enums (TransactionType, Currency, etc.)
│   │   ├── Http/
│   │   │   ├── Controllers/   # REST API controllers
│   │   │   ├── Middleware/    # CSP, ForceHTTPS, EnsureSessionValid
│   │   │   ├── Requests/      # Form request validation
│   │   │   └── Resources/     # API response transformers
│   │   ├── Models/       # Eloquent models
│   │   ├── Services/     # ExchangeRate, CurrencyConversion, Analytics
│   │   └── Jobs/         # Background jobs (rates, recurring, bills)
│   ├── database/
│   │   ├── migrations/
│   │   └── seeders/      # Categories, currencies, demo data
│   └── routes/api.php
├── frontend/            # Next.js 16 SPA
│   └── src/
│       ├── app/          # App Router pages (auth + dashboard groups)
│       ├── components/   # UI components (shadcn/ui base-ui)
│       ├── lib/
│       │   ├── api.ts    # Sanctum SPA client (CSRF, 401/419 handling)
│       │   ├── hooks/    # TanStack Query hooks
│       │   └── utils.ts
│       └── types/        # TypeScript models (source of truth)
├── PLAN.md              # Full feature spec and roadmap
└── README.md

Environment

Security Notes

• Single-user auth — no public registration
• Session bound to IP + User-Agent (EnsureSessionValid middleware)
• Auto-logout after 15 min of inactivity
• All monetary data stays local; only exchange-rate fetches reach out
• Receipts encrypted on the local disk

Author

Built by Bashar Ayyash.

License

Released under the MIT License.