A modern web application for tracking personal finances, visualizing spending patterns, and managing budgets.
Built with React (Vite), Tailwind CSS, ShadCN UI, FastAPI, and PostgreSQL.

Status: 🚧 Under Development

• Authentication & Authorization – secure sign-up, and login.
• Expense Tracking – log and categorize income & expenses.
• Data Visualization – interactive charts & insights for spending habits, categories, and trends.
• Dashboard Overview – quick glance at balances, budgets, and recent activity.
• User Profile & Preferences – customizable settings, currency support, etc.
• Goals & Budgets (Future) – set savings goals and track budget progress.

Frontend: React JS + Vite, Tailwind CSS, ShadCN UI.
Backend: FastAPI, PostgreSQL

Follow these steps to run the project locally:

git clone https://github.com/alishanawer/personal-finance-dashboard.git

cd personal-finance-dashboard

cd frontend

npm install

npm run dev

Your frontend should now be running on http://localhost:5173

cd ../backend

• Create virtual environment:

python -m venv venv

• Activate virtual environment:

source venv/bin/activate   # On Linux/Mac

venv\Scripts\activate      # On Windows

• Install dependencies:

pip install -r requirements.txt

This project uses PostgreSQL.

1. Make sure PostgreSQL is installed and running locally.
2. Create a new database, e.g. finance_db.
3. Update your .env file with your own database credentials:

DATABASE_URL=postgresql://username:password@localhost:5432/finance_db
SECRET_KEY=your_secret_key

⚠️ You’ll need to create your own .env file in the backend/ folder (not committed to GitHub).

uvicorn main:app --reload

Backend should now be running on http://localhost:8000

This project is licensed under the MIT License.