💰 MoneyMap - Personal Finance Tracker

A Modern MERN Stack Personal Finance Management Application

---

📖 About

MoneyMap is a full-stack MERN application that helps users efficiently manage their personal finances.

Users can:

• 💰 Track Income & Expenses
• 📊 View Financial Dashboard
• 📈 Analyze Spending Habits
• 📄 Export Reports as PDF & CSV
• 💳 Plan Monthly Budgets
• 🤖 Get AI-Based Financial Insights

---

🌐 Live Demo

🚀 Frontend

https://money-map-seven-alpha.vercel.app

⚙️ Backend API

https://moneymap-backend-7qhb.onrender.com

---

✨ Features

🔐 Authentication

• User Registration
• Secure Login
• JWT Authentication
• Protected Routes
• Logout

---

💰 Transaction Management

• Add Income
• Add Expense
• Edit Transaction
• Delete Transaction
• Search Transactions
• Filter by Category
• Filter by Type
• Filter by Month

---

📊 Dashboard

• Current Balance
• Total Income
• Total Expense
• Total Transactions
• Monthly Expense Bar Chart
• Category Expense Pie Chart
• Recent Transactions

---

📂 Categories

• Expense Categories
• Income Categories
• Category Summary
• Pie Chart Analytics

---

📈 Reports

• Date Range Report
• Monthly Summary
• Income vs Expense
• Category Analysis
• Download PDF
• Download CSV

---

💳 Budget Planning

• Monthly Budget
• Spending Tracker
• Budget Progress
• Overspending Alert

---

🤖 AI Analytics

• Spending Analysis
• Financial Insights
• Smart Recommendations

---

⚙️ Settings

• User Profile
• Theme
• Currency
• Notifications
• Password Update

---

🧰 Technologies & Tools Used

🎨 Frontend

• React.js
• Vite
• React Router DOM
• Axios
• HTML5
• CSS3
• JavaScript (ES6+)
• HTML2Canvas
• jsPDF

---

⚙️ Backend

• Node.js
• Express.js
• REST APIs
• JWT Authentication
• bcryptjs
• dotenv
• CORS

---

🗄 Database

• MongoDB Atlas
• Mongoose ODM

---

📊 Data Visualization

• Dashboard Cards
• Bar Charts
• Pie Charts

---

📄 Export Features

• PDF Export
• CSV Export

---

☁️ Deployment

• Vercel
• Render
• MongoDB Atlas
• GitHub

---

🧠 Concepts Used

• CRUD Operations
• REST API Development
• MVC Architecture
• JWT Authentication
• Authorization Middleware
• Password Hashing
• Environment Variables
• Axios API Integration
• React Hooks
• Form Validation
• Search & Filtering
• Category-wise Aggregation
• Monthly Expense Analysis
• Responsive UI Design
• Error Handling
• Async/Await
• Cloud Deployment

---

📌 API Endpoints

Authentication

• POST /api/auth/register
• POST /api/auth/login

Expenses

• GET /api/expenses
• POST /api/expenses
• PUT /api/expenses/:id
• DELETE /api/expenses/:id

Dashboard

• GET /api/dashboard
• GET /api/dashboard/category-summary
• GET /api/dashboard/monthly-summary

---

📸 Screenshots

🏠 Landing Page

---

🔑 Login

---

📝 Register

---

📊 Dashboard

---

💰 Add Transaction

---

📜 Expense History

---

📂 Categories

---

📈 Reports

---

💳 Budget Planning

---

🤖 AI Analytics

---

⚙️ Settings

---

📁 Project Structure

MoneyMap
│
├── backend
│   ├── config
│   ├── controllers
│   ├── middleware
│   ├── models
│   ├── routes
│   ├── server.js
│   └── package.json
│
├── frontend
│   ├── src
│   ├── public
│   ├── package.json
│   └── vite.config.js
│
└── README.md

---

⚙️ Installation

Clone Repository

git clone https://github.com/adarshsingh31/MoneyMap.git

cd MoneyMap

---

Backend

cd backend
npm install

Create a .env

MONGO_URI=your_connection_string
JWT_SECRET=your_secret
PORT=5000

Run

npm start

---

Frontend

cd frontend
npm install

Create a .env

VITE_API_URL=http://localhost:5000/api

Run

npm run dev

---

🚀 Future Improvements

• Email Verification
• Forgot Password
• Google Authentication
• Recurring Transactions
• Expense Reminders
• Multi-Currency Support
• Mobile App
• AI Expense Prediction

---

🏆 Skills Demonstrated

• Full Stack MERN Development
• Frontend Development
• Backend API Development
• Database Design
• Authentication & Security
• REST API Integration
• Cloud Deployment
• Git & GitHub
• Data Visualization
• Problem Solving

---

👨‍💻 Author

Adarsh Singh

GitHub: https://github.com/adarshsingh31

LinkedIn: https://www.linkedin.com/in/adarsh-singh-936380341/

---

⭐ Support

If you like this project, don't forget to ⭐ the repository.

It helps others discover the project and motivates future improvements.