Skip to content

jaydxxp/Expensio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 

Repository files navigation

💰 Expensio — Smart MERN + TypeScript Expense Tracker

Expensio is a next-generation MERN Stack expense tracker built with TypeScript that helps you track, visualize, and analyze your spending effortlessly.
With AI insights, real-time currency conversion, and a cinematic dashboard, Expensio makes personal finance smart, intuitive, and fun.


🚀 Features

🧩 Core Functionalities

  • Add Expense with:
    • Title, Amount, Category, Date
    • Optional: Notes, Recurring checkbox
  • Edit / Delete / View Expenses easily
  • Dashboard Overview showing:
    • 💸 Total expense
    • 🏆 Top spending category
    • 🔁 Recurring expenses summary
    • 📅 Daily average spend
  • Search & Filter by category or keyword
  • CSV-based Categories (no backend calls required)

⚡ Advanced & Bonus Features

  • 🤖 AI Assistant (Microservice)
    Ask natural questions like:

    “Where did I spend the most last week?”
    “How much did I spend on travel this month?”

  • 💱 Real-Time Currency Converter (Microservice)
    Convert between currencies instantly with live rates.
  • 🧮 Smart Calculator (Microservice)
    Do quick calculations without leaving the dashboard.
  • 📊 Interactive Charts with Chart.js
    Visualize your data with:
    • Category-wise Expense Pie Chart
    • Monthly Expense Trend Line Chart
  • 🔁 Recurring Expense Management
  • 🕓 Expense History & Search
  • 🌙 Dark Mode UI with grid-line background
  • 📱 Fully Responsive — optimized for desktop, tablet, and mobile
  • 🎞️ Cinematic Scroll Animation — dashboard “wakes up” as you scroll

🧠 Tech Stack

🖥️ Frontend

  • React.js (TypeScript)
  • TailwindCSS
  • Chart.js (via react-chartjs-2)
  • React Router DOM
  • React Hooks (useState, useEffect, useContext)

⚙️ Backend

  • Node.js + Express.js
  • MongoDB + Mongoose
  • TypeScript
  • JWT Authentication
  • Zod (for validation)
  • Google Gemini API (for AI Assistant)

🧩 Microservices

  • AI Assistant Service — contextual expense queries
  • Currency Converter Service — real-time rates
  • Calculator Service — inline math operations

💡 Highlights

  • 🧱 TypeScript-based architecture (frontend & backend)

  • ✅ Zod validation for safer data handling

  • 🧩 Microservice-driven modular design

  • 🕸️ Subtle grid-line background pattern

  • 🧠 Built-in AI, charts, and tools — all in one dashboard


🧾 Deployment

  • Frontend: Vercel
  • Backend: Render
  • Database: MongoDB Atlas

🌟 Final Thoughts

Expensio isn’t just another expense tracker — it’s your personal finance companion built for the modern web.
It blends data visualization, AI-powered insights, and microservice-driven architecture to help you make smarter financial decisions with ease and clarity.

Whether you’re a developer exploring the MERN + TypeScript ecosystem,
or someone looking to take control of your finances,
Expensio is designed to be simple, intelligent, and extensible.


💬 Feedback & Contributions

Got an idea to improve Expensio?
Feel free to open an issue, fork the repo, or submit a pull request — every contribution matters!
Let’s make personal finance management beautiful and insightful together.


🌐 Connect

👨‍💻 Author: Jaydeep 📧 Email: jaydeepwaghaskar@gmail.com 🐙 GitHub: @jaydxxp
🔗 LinkedIn: LinkedIn Profile


“Control your expenses, or your expenses will control you.”
Expensio

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages