Expenso - Smart Expense Tracker

Expenso is a full-stack web application designed to help users track and manage their personal expenses efficiently. Built with modern technologies, it provides a seamless experience for monitoring spending habits, categorizing expenses, and gaining financial insights.

Why Expenso?

Expenso stands out by combining a robust backend with a beautiful, user-friendly frontend. It's designed for both technical excellence and practical utility, making expense tracking simple and effective for everyday users while maintaining a codebase that's clean and maintainable for developers.

Features

• Dashboard Analytics - Visualize spending with interactive charts
• Expense Management - Add, edit, and track expenses
• Responsive Design - Works perfectly on all devices
• Category Tracking - Organize expenses by categories
• Secure Authentication - Token-based user authentication
• Monthly Reports - View spending trends over time

Live Demo

• [ LINK ]

Tech Stack

Frontend:

• Next.js 15 with App Router
• TypeScript
• Tailwind CSS + shadcn/ui
• Recharts for data visualization
• Axios for API calls

Backend:

• Django REST Framework
• SQLite Database
• Token Authentication
• CORS enabled

Quick Start

Prerequisites

• Node.js 18+
• Python 3.10+
• Git

Local Development

1. Clone the repository

git clone https://github.com/yourusername/expenso.git
cd expenso

2. Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

3. Frontend Setup

cd frontend
npm install
npm run dev

4. Open your browser

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000/api

Deployment

This project is deployed using:

• Frontend: Vercel
• Backend: Render

Project Structure

expenso/
├── frontend/                 # Next.js application
│   ├── app/
│   │   ├── login/           # Authentication pages
│   │   ├── register/
│   │   └── dashboard/       # Main application
│   ├── components/          # Reusable UI components
│   └── lib/
│       └── api.ts          # API configuration
│
└── backend/                 # Django application
    ├── main/               # Project settings
    └── expenses/           # Core app
        ├── models.py       # Data models
        ├── views.py        # API views
        ├── serializers.py  # Data serialization
        └── urls.py         # API routes

License

MIT License - feel free to use this project for personal or commercial purposes.

Built with by Aryan Rangapur