Skip to content

Latest commit

 

History

129 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

ExpenseAI: Smart Expense Tracking & Financial Insights

ExpenseAI is a modern, AI-powered expense tracking application designed to help users manage their finances intelligently. This full-stack application provides real-time expense tracking, predictive analytics, and personalized financial insights.


🔹 Key Features

User Experience

  • Secure Authentication: JWT-based authentication with Google OAuth 2.0 support
  • Responsive Design: Fully mobile-optimized interface built with TailwindCSS
  • Interactive Dashboards: Real-time data visualization with Recharts
  • Role-Based Access: Separate interfaces for users and administrators

Core Functionality

  • Expense Tracking: Categorize and log expenses on-the-go
  • AI-Powered Predictions: Forecast future spending patterns
  • Smart Categorization: Automatic expense categorization
  • Data Export: Download expense reports in CSV, PDF, and Excel formats
  • Multi-Currency Support: Track expenses in multiple currencies

Advanced Features

  • Budget Management: Set and track spending limits
  • Recurring Expenses: Schedule and monitor regular payments
  • Receipt Scanning: Upload and process expense receipts
  • Financial Analytics: Visual breakdowns of spending trends

🛠️ Technology Stack

Frontend

  • Framework: React 19 + Vite
  • State Management: Redux Toolkit
  • Styling: TailwindCSS + Headless UI
  • AI integration: FastApi + Pandas + Scikit-learn (Random-Forest)
  • Charts & Analytics: Recharts
  • Form Handling: Formik with Yup validation
  • HTTP Client: Axios with interceptors
  • Icons: Lucide React

Backend

  • Runtime: Node.js + Express.js
  • Authentication: JWT + Passport.js (Google OAuth)
  • Database: MongoDB with Mongoose ODM
  • Session Management: Express-session with Redis
  • API Documentation: Swagger/OpenAPI
  • Validation: Joi

DevOps & Deployment

  • Frontend Hosting: Vercel
  • Backend Hosting: Railway
  • Database: MongoDB Atlas
  • CI/CD: GitHub Actions
  • Environment Management: Dotenv

🚀 Technical Achievements

  • Secure cross-origin authentication between Vercel (frontend) and Railway (backend)
  • Performance optimization using code splitting and lazy loading
  • Comprehensive error tracking and logging

🌟 Why It Stands Out

  • AI/ML Integration: Predictive analytics for smarter financial planning
  • Enterprise-Grade Security: OWASP-compliant security practices
  • Scalable Architecture: Microservices-ready design
  • Comprehensive Testing: 90%+ test coverage
  • Accessibility: WCAG 2.1 AA compliant

🔗 Project Links


📌 Installation & Setup

# Clone the repository
git clone https://github.com/your-username/expenseai.git
cd expenseai

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

# Environment variables
cp .env.example .env
# Fill in your MongoDB URI, JWT secret, Google OAuth credentials, etc.

# Run development servers
# Backend
cd ../backend
npm run dev
# Frontend
cd ../frontend
npm run dev

Releases

Packages

Contributors

Languages