An open API service indexing awesome lists of open source software.

https://github.com/ak4shkr/expense-tracker

A modern solution to track your expenses, analyze spending patterns, and stay financially smart.
https://github.com/ak4shkr/expense-tracker

axios jwt-authentication mantine-ui nodejs reactjs reactquery

Last synced: 3 months ago
JSON representation

A modern solution to track your expenses, analyze spending patterns, and stay financially smart.

Awesome Lists containing this project

README

          

# 💸 Expense Tracker Application

*A modern solution to track your expenses, analyze spending patterns, and stay financially smart.*

![Screenshot 2025-04-29 003830](https://github.com/user-attachments/assets/8b600c5f-272a-4b3d-bedd-9de7822bfca5)

---

## 🌟 Features

- Add, Edit, and Delete your expenses effortlessly
- Authentication with separate user, seprate data
- search across the list
- Stats Cards for quick insights
- Monthly-wise Expense Chart
- Category-wise Expense Distribution
- Responsive design for all devices
- Real-time updates with React Query
- Toast Notifications for feedback

---

## 🛠️ Tech Stack

### Backend
| Technology | Purpose |
|------------|---------|
| Express.js | Server-side Framework |
| Node.js | Backend Runtime |
| JWT | Authentication |
| MongoDB | Database |
| CORS | Cross-Origin Resource Sharing |
| Nodemon | Development Server |
| Bcrypt | Password Encryption |

### Frontend
| Technology | Purpose |
|------------|---------|
| React | Frontend Library |
| React Query | caching |
| Mantine | UI Components |
| Tailwind CSS | Styling |
| Axios | API Requests |

---

## 📂 Project Structure

```
src/

├── components/ // Reusable UI components
├── hooks/ // Custom React hooks
├── utils/ // Utility functions
├── pages/ // pages screen
└── App.jsx // Main Application File
```

---

## 📊 Highlights

- **Monthly Expense Charts**: Visualize your monthly spending.
- **Category Breakdown**: See where your money is going.
- **Stat Cards**: Quick view of total expenses, number of transactions, and highest category.
- **Edit/Delete**: Modify or remove expenses with a click.
- **Notifications**: Get instant feedback on actions.

## Performance on TOP
![Screenshot 2025-04-29 013606](https://github.com/user-attachments/assets/10a87fd9-2a49-4418-812c-5a87d48e71f9)

---

## 🚀 Getting Started
```bash
git clone https://github.com/ak4shKr/expense-tracker
```

### Backend Setup

1. **Install dependencies:**
```bash
cd backend
npm install
```

2. **Set up `.env` file:**
```
DB_URL=your_mongodb_connection_string
JWT_SECRET=your_secret_key
PORT=3000
```

3. **Run the server:**
```bash
npm start
```
---

### Frontend Setup

1. **Navigate to frontend directory and install dependencies:**
```bash
cd frontend
npm install
```

2. **Run the frontend:**
```bash
npm run dev
```
---

## 📸 Screenshots
**Responsive Application for all devices and with good sense of design and colors with impressice UI, acroos the platform we setted modal, drawer, scrollable list, sticky navbar, consistent colors...
please check it out below shots.**:

![Screenshot 2025-04-29 010706](https://github.com/user-attachments/assets/39efd060-52ba-4cf9-88a6-c03b9540a559)

![Screenshot 2025-04-29 003247](https://github.com/user-attachments/assets/98418c5f-9734-4760-93c5-8dd440704457)

![Screenshot 2025-04-29 003222](https://github.com/user-attachments/assets/a4a0cc80-94ba-4e7e-9ca2-fafc587b278e)

![Screenshot 2025-04-29 003206](https://github.com/user-attachments/assets/0c13cd6b-cd91-42d1-b6d4-f9559a3ecd1c)

![Screenshot 2025-04-29 003141](https://github.com/user-attachments/assets/776c0fe1-a7d3-4c6d-b658-d276d3fc695b)

---

## ❤️ Special Thanks

Built with passion, precision, and a little bit of coffee ☕.

---