A full-stack Expense Tracker application built with the MERN stack (MongoDB, Express, React, Node). This README is optimized for clarity and contributors, especially for Hacktoberfest 2025.
- 🔐 User authentication (JWT)
- ✏️ Add, edit, delete expenses
- 📊 Visual summary with interactive charts
- 📱 Responsive UI and Tailwind-ready styles
Frontend ⚛️
- React (Vite)
- Tailwind CSS
- Recharts
Backend 🧩
- Node.js & Express
- MongoDB (Mongoose)
- JWT for authentication
Prerequisites 🧾
- Node.js (v20+ recommended as Vite requires Node.js version 20.19+ or 22.12+)
- MongoDB (local or Atlas)
- Git
Clone the repository
git clone https://github.com/Sathvikaeshkilla/mern-expense-tracker.gitcd mern-expense-trackerInstall server dependencies
cd server; npm installInstall client dependencies
cd ../client; npm installEnvironment Variables :
Create a .env file in the server directory based on .env.example:
cp server/.env.example server/.envRun in development (two terminals)
# Terminal 1 - server
cd server; npm start
# Terminal 2 - client
cd client; npm run devContributions are welcome. Please:
- 🐛 Open issues for bugs or feature requests
- ✨ Send a focused pull request with a clear description
- ✅ Keep changes small and test locally before opening a PR
For Hacktoberfest 2025: label your PR with hacktoberfest if it follows the project guidelines.
This project is licensed under the MIT License. See the LICENSE file for details.
If you find this project useful, consider starring the repo. For quick questions or coordination, open an issue and tag the maintainers.
Maintainer: Assigned — coordinate via GitHub issues. 🧑🔧