Skip to content

README.md

Latest commit

 

History

History
105 lines (77 loc) · 3.37 KB

README.md

File metadata and controls

105 lines (77 loc) · 3.37 KB
Raw

💰 ExpensePro Full-Stack

React 19 Node.js MongoDB Vite

A premium full-stack expense tracker with dark glassmorphism UI, secure JWT authentication, and beautiful Recharts analytics. 📈

Live Demo • Report Bug • Request Feature

🌟 About The Project

ExpensePro is designed to help you take complete control of your finances. With a focus on user experience and data visualization, this app allows you to track income and expenses effortlessly while providing insightful analytics to help you save more.

✨ Key Features

  • Dark Glassmorphism UI: Stunning, modern, and responsive design.
  • Secure Authentication: JWT-based login and registration system.
  • Advanced Analytics: Visualize spending patterns using interactive Pie, Bar, and Area charts (powered by Recharts).
  • Extensive Categories: 19 built-in expense categories for precise tracking.
  • Real-time Sync: Powered by MongoDB Atlas for instant data updates.

🚀 Getting Started

Follow these steps to set up the project locally on your machine.

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn
  • MongoDB Atlas account (or local MongoDB)

Installation

  1. Clone the repository

    git clone https://github.com/buildbyabhi/expensepro-fullstack.git
cd expensepro-fullstack

  2. Install Frontend Dependencies

    cd frontend
npm install

  3. Install Backend Dependencies

    cd ../backend
npm install

  4. Set up Environment Variables Create a .env file in the backend directory:

    PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_super_secret_key

  5. Run the App Open two terminals:

    • Terminal 1 (Backend): cd backend && npm start
    • Terminal 2 (Frontend): cd frontend && npm run dev

🛠️ Tech Stack

  • Frontend: React 19, Vite, TailwindCSS (if applicable), Recharts
  • Backend: Node.js, Express.js
  • Database: MongoDB, Mongoose
  • Auth: JSON Web Tokens (JWT), bcrypt

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Don't forget to give the project a star! Thanks again! ⭐

  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

📬 Contact

Abhishek Kumar

Made with ❤️ by Abhishek