Skip to content

AdityaGupta2804/Fintrack

Repository files navigation

FinTrack – Personal Finance Tracker Web App

FinTrack is a smart, modern web app to track your income and expenses, analyze spending patterns, and stay in control of your finances.


Project Demo

FinTrack Architecture
FinTrack Demo

Project Overview

FinTrack is a digital finance manager that helps you record, view, and analyze your money flow.

Whether you're a student, a working professional, or just budget-conscious, FinTrack gives you an intuitive way to:

  • Add income or expense entries
  • Categorize them
  • View real-time financial analytics

It works like your personal money diary — simple, beautiful, and powerful.


Technical Overview

FinTrack is a full-stack MERN application (MongoDB, Express.js, React, Node.js) designed with modern tools for performance and user experience.

Key Technical Highlights:

  • Fully responsive UI built with Ant Design
  • JWT-based authentication for secure user login
  • Single Page Application (SPA) using React
  • Dynamic state updates with Context API
  • Real-time analytics and smart data visualization
  • Modular backend integrated with MongoDB and REST APIs

Key Features

  • Add / Edit / Delete Transactions
  • Filter by Date Range
  • Filter by Type (Income / Expense)
  • Earnings vs. Expenses Breakdown
  • Category-wise Analysis
  • User Authentication (Login / Logout)
  • Dynamic UI Updates without Page Reloads
  • Responsive Design with Ant Design Components

Architecture Diagram

FinTrack Architecture
FinTrack Architecture Diagram

This diagram shows how the frontend, backend, database, and authentication system work together in FinTrack.


Tech Stack

Layer Technology Used Purpose
Frontend React.js, Ant Design UI, Components, and Styling
Backend Node.js, Express.js REST API & Business Logic
Database MongoDB Persistent Storage for Transactions
State Management React Context API + useReducer Global State Handling
Authentication JSON Web Tokens (JWT) Secure Login and Session Management
Environment dotenv Environment Variable Configuration
Deployment Vercel (Frontend), Render (Backend) App Hosting

Getting Started

Prerequisites

  • Node.js v14.6+ (required for ES Modules support)
  • MongoDB URI
  • Git

Installation

# 1. Clone the Repository
git clone https://github.com/guptasamarth200/FinTrack.git
cd FinTrack
# 2. Configure Environment Variables
touch .env

Add the following inside your .env file:

NODE_ENV=development
PORT=5000
MONGO_URI=your_mongodb_connection_string
# 3. Install Backend Dependencies
npm install
# 4. Move to Frontend and Install Dependencies
cd frontend
npm install

Running the Application

To run both frontend and backend:

npm run start

To run backend only:

node server.js

Build & Deployment

To create a production build:

cd frontend
npm run build

Notes

  • Backend uses ES Modules, so ensure you're using Node.js v14.6+
  • When importing local files, always include the .js extension
  • Babel can be added if compatibility with older Node versions is needed

Conclusion

FinTrack simplifies personal finance tracking through a clean, modern, and mobile-friendly interface. It’s ideal for anyone looking to understand their earnings vs. expenses, control spending habits, and get actionable insights — all in real-time.


License

This project is licensed under the MIT License. See the LICENSE file for full details.


Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request to help improve the project.

About

A full-stack personal finance tracker that helps users manage expenses, visualize cash flow, and optimize savings through clean dashboards and smart categorization.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors