A full-stack expense tracking application built with the MERN stack (MongoDB, Express.js, React, Node.js) that helps users manage their personal finances, track expenses, and set budgets effectively.
- 💵 Track both expenses and income
- 📊 Monthly budget management
- 📅 Date-wise expense tracking
- 🏷️ Category-based expense organization
- 📈 Visual expense analytics
- 💻 Responsive design for all devices
- Frontend: React + Vite
- Backend: Node.js + Express.js
- Database: MongoDB
- Styling: [Your CSS Framework]
- Charts: [Your Chart Library]
- Node.js (v14 or higher)
- MongoDB Atlas account
- Git
- Clone the repository
git clone https://github.com/yourusername/finance-tracker.git
Copy
Apply
README.md
Install server dependencies
cd finance-tracker/server
npm install
Copy
Execute
Install client dependencies
cd ../client
npm install
Copy
Execute
Configure environment variables Create a .env file in the server directory:
MONGODB_URI=your_mongodb_connection_string
PORT=5000
Copy
Apply
Start the server
cd ../server
npm start
Copy
Execute
Start the client
cd ../client
npm run dev
Copy
Execute
The application should now be running on http://localhost:5173
🔧 Configuration
Update the MongoDB connection string in server/config/db.js with your database credentials.
📁 Project Structure
finance-tracker/
├── client/
│ ├── src/
│ ├── public/
│ └── package.json
└── server/
├── config/
├── models/
├── routes/
└── server.js
Copy
Apply
🌟 Features in Detail
Expense Management
Add, edit, and delete expenses
Categorize expenses
Track expense dates
Budget Planning
Set monthly budgets
Track budget utilization
Get alerts for budget overruns
Income Tracking
Record multiple income sources
Track regular and one-time income
🔐 API Endpoints
POST /api/expenses - Create new expense
GET /api/expenses - Get all expenses
POST /api/budgets - Create new budget
GET /api/budgets - Get all budgets
🎨 Screenshots
📱 Mobile Responsiveness
The application is fully responsive and works seamlessly across:
Desktop browsers
Tablets
Mobile devices
🔍 Future Enhancements
Multi-currency support
Export reports to PDF/Excel
Dark mode
Budget forecasting
Bill reminders
🔒 Security
MongoDB Atlas for secure database hosting
Environment variables for sensitive data
Input validation and sanitization
⚡ Performance
Optimized React components
Efficient database queries
Lazy loading for better load times