Skip to content

Diwakar-odds/Finance_track

Repository files navigation

Finance Track - Expense Tracker Application

A comprehensive expense tracking application built with a modern React frontend and a robust Node.js/Express backend. Track your expenses, set budgets, and visualize your financial health.

Features

  • Expense Tracking: Log and categorize your daily expenses.
  • Budget Management: Set monthly limits for different categories.
  • Visualizations: Interactive charts and graphs to analyze spending patterns.
  • User Authentication: Secure signup and login functionality.
  • Responsive Design: Works seamlessly on desktop and mobile devices.

Tech Stack

Frontend:

  • React 18
  • Vite
  • TypeScript
  • Tailwind CSS
  • Material UI
  • Recharts (for visualization)

Backend:

  • Node.js
  • Express.js
  • MongoDB (with Mongoose)
  • JSON Web Tokens (JWT) for authentication

Getting Started

Prerequisites

  • Node.js (v18+ recommended)
  • npm or yarn
  • MongoDB Atlas account (or local MongoDB instance)

Installation

  1. Clone the repository:

    git clone https://github.com/your-username/Finance_track.git
    cd Finance_track
  2. Install Frontend Dependencies:

    npm install
  3. Install Backend Dependencies:

    cd server
    npm install
    cd ..

Configuration

  1. Backend Environment Variables:

    • Navigate to the server directory.
    • Create a .env file based on .env.example:
      cp server/.env.example server/.env
    • Update the MONGODB_URI and JWT_SECRET with your own credentials.
  2. Frontend Environment Variables:

    • Navigate to the root directory.
    • Create a .env file based on .env.example (if needed for custom API URL):
      cp .env.example .env

Running the Application

To run both the frontend and backend concurrently (recommended for development):

npm run dev
  • Frontend will be available at http://localhost:5173
  • Backend will run on http://localhost:5000

Build for Production

To build the frontend for production:

npm run build

Contributing

Contributions are always welcome!

  1. Fork the repository on GitHub.
  2. Clone your fork locally:
    git clone https://github.com/your-username/Finance_track.git
  3. Create a new branch for your feature or bug fix:
    git checkout -b feature/amazing-feature
  4. Make your changes and commit them:
    git commit -m "Add some amazing feature"
  5. Push to your branch:
    git push origin feature/amazing-feature
  6. Open a Pull Request on GitHub against the main branch.

License

MIT

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors