FlowCap is my first full-stack development project, built for the Finova recruitment challenge. It is a personal-finance app for students and young professionals who want a clearer answer than “how much money is left this month?”
Instead, FlowCap calculates a Safe Daily Allowance (SDA): the amount that is safe to spend today while staying on track for the rest of the budget cycle.
- Dynamic Safe Daily Allowance that updates after every transaction
- Budget onboarding for income, fixed expenses, savings target, emergency buffer, and cycle start date
- Manual transaction creation, editing, deletion, search, and filters
- BHIM UPI transaction-statement PDF import with an editable preview
- Automatic debit/credit detection, categorisation, and duplicate detection for imported UPI transactions
- Upcoming-expense reservations so planned bills reduce available spending
- Category spending caps with progress indicators
- Dashboard metrics, spending charts, budget health, and rule-based insights
- Under-budget streak calendar
- What-if purchase simulator and end-of-cycle forecast
- JWT-based authentication and per-user data
| Layer | Technology |
|---|---|
| Frontend | React 19, Vite, Tailwind CSS |
| Visuals | Recharts, Lucide React |
| Backend | Python, FastAPI, Uvicorn |
| Database | SQLite |
| Authentication | JSON Web Tokens (PyJWT) |
| PDF parsing | pypdf, with a pdftotext fallback |
| Deployment | Docker and Docker Compose |
- Docker Engine with Docker Compose v2
From the repository root, build the images and start both services:
docker compose up --build -dOpen the app at http://localhost:5173. The FastAPI API is available at http://localhost:8000, with interactive API documentation at http://localhost:8000/docs.
# Follow logs from both services
docker compose logs -f
# Stop the services without removing containers
docker compose stop
# Start stopped services again
docker compose start
# Stop and remove the containers
docker compose downFlowCap uses SQLite. The current Docker setup keeps the database inside the backend container, so avoid
docker compose downif you need to retain local data. For a production deployment, mount the SQLite database on persistent storage or move to a managed database.
FlowCap/
├── frontend/ # React/Vite client served by Nginx in Docker
├── backend/ # FastAPI API and SQLite database logic
├── docker-compose.yml # Starts the frontend and backend together
└── features.md # Product requirements and feature notes
SDA = (disposable funds − fixed expenses − total spent
− reserved upcoming expenses − emergency buffer) / days remaining
This makes the budget adapt as spending changes, so overspending today is reflected in the amount available for the remaining days.