🚀 Smart Expense Tracker with AI Insights

A modern, intelligent expense tracking application with predictive analytics, budget management, and beautiful data visualizations. Built for the Indian market with INR currency support.

✨ Features

💡 AI-Powered Intelligence

• Predictive Analytics: Forecast next month's spending using trend analysis
• Smart Insights: Automatic detection of spending patterns and anomalies
• Budget Alerts: Real-time notifications when approaching or exceeding budgets

📊 Comprehensive Analytics

• Interactive Charts: Line, bar, and pie charts for data visualization
• Monthly Trends: Track spending patterns over time
• Category Breakdown: Detailed analysis of spending by category

🎯 Budget Management

• Category Budgets: Set individual budgets for each spending category
• Visual Progress: Color-coded progress bars showing budget utilization
• Overspending Alerts: Get notified when exceeding budget limits

🔄 Advanced Features

• Recurring Expenses: Tag and track monthly recurring payments
• CRUD Operations: Full create, read, update, delete functionality
• Data Persistence: Automatic saving with persistent storage
• Import/Export: Backup and restore data as JSON files
• Responsive Design: Works seamlessly on mobile and desktop

🛠️ Tech Stack

• Frontend: React 18 with Hooks (useState, useEffect)
• Charts: Recharts for interactive data visualization
• Styling: Tailwind CSS for modern, responsive UI
• Icons: Lucide React for beautiful icons
• Storage: Persistent Storage API for data management
• Currency: Indian Rupee (₹) support

🚀 Getting Started

Prerequisites

• Node.js (v14 or higher)
• npm or yarn

Installation

1. Clone the repository

git clone https://github.com/yourusername/smart-expense-tracker.git
cd smart-expense-tracker

2. Install dependencies

npm install

3. Start the development server

npm start

4. Open http://localhost:3000 in your browser

📱 Usage

Adding Expenses

1. Navigate to the "Add Expense" tab
2. Enter amount, category, description, and date
3. Mark as recurring if it's a monthly expense
4. Click "Add Expense"

Setting Budgets

1. Go to the "Budgets" tab
2. Enter budget amounts for each category
3. Monitor spending with visual progress bars

Viewing Analytics

1. Check the "Dashboard" for comprehensive insights
2. View monthly trends, category distribution, and predictions
3. Read smart insights for personalized recommendations

Managing Data

• Export: Download your data as JSON from the History tab
• Import: Upload previously exported data to restore

📸 Screenshots

Dashboard

Expense History

Budget Management

🎯 Key Algorithms

Predictive Analysis

The app uses a simple moving average with trend analysis:

• Calculates average spending over the last 3 months
• Analyzes spending trend (increasing/decreasing)
• Predicts next month's spending based on trend momentum

Budget Tracking

• Real-time calculation of spent vs. budgeted amounts
• Color-coded alerts (green < 80%, yellow 80-100%, red > 100%)
• Percentage-based progress visualization

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author

Your Name

• GitHub: @yourusername
• LinkedIn: Your LinkedIn

🙏 Acknowledgments

• Built with React and Recharts
• Icons by Lucide React
• Styled with Tailwind CSS

📈 Future Enhancements

• Multiple currency support
• Cloud sync across devices
• Receipt image upload and OCR
• Advanced ML-based predictions
• Spending categories customization
• Dark mode support
• Multi-user/family accounts
• Bank account integration

---

⭐ If you found this project helpful, please give it a star!

### **3. Create `.gitignore`**

dependencies

/node_modules /.pnp .pnp.js

testing

/coverage

production

/build

misc

.DS_Store .env.local .env.development.local .env.test.local .env.production.local

npm-debug.log* yarn-debug.log* yarn-error.log*

IDE

.vscode/ .idea/ *.swp *.swo *~

### **4. Create `LICENSE`**

MIT License

Copyright (c) 2025 [Your Name]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.