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

No packages published

Languages