📊 Trackifi

A full-stack web app to help users track expenses and manage spending with visual insights.

Table of Contents

• Introduction
• Live Demo
• Features
• Prerequisites
• Installation
• Deployment
• Contributing
• License

---

Introduction

Trackifi is a personal finance web app that empowers users to manage spending, track expenses, set budgets, and gain financial insights through intuitive visualizations.

The frontend is built using React, TypeScript, and Vite, offering a fast and responsive user experience. The backend is powered by Spring Boot (Java) and connects to a cloud-hosted Neon PostgreSQL database. The backend is containerized with Docker and published on Docker Hub.

---

Live Demo

🌐 Visit the website: Trackifi

The PWA version can be installed on both desktop and mobile by clicking "Install Trackifi".

---

Features

• Transaction Management: Easily add, edit, and delete income or expense records.
• Visual Analytics: Interactive bar and pie charts show monthly and category-wise spending.
• Dashboard Overview: At-a-glance view of total spent, active budgets and active categories.
• Budget Tracking: Set monthly budgets per category and compare actual vs planned spending.
• Smart Alerts: Get notified via email when spending exceeds set limits.

---

Prerequisites

• Java 17+ – for running the Spring Boot backend
• Maven – to build the Java project
• Neon PostgreSQL account – for the cloud database (or local PostgreSQL setup)
• Docker – to build and run the backend container (optional but recommended)
• Node.js v18+ – for running the React + Vite frontend

---

Installation

Frontend

git clone https://github.com/ruthvik-mt/Trackifi.git
cd frontend
npm install

Backend

cd backend
.\mvnw spring-boot:run

Dockerize Backend

The Spring Boot backend is fully containerized using Docker and can be built, run locally, or pushed to Docker Hub for deployment.

Build Docker Image

From the backend directory:

docker build -t your-dockerhub-username/finance-tracker 
docker push your-dockerhub-username/finance-tracker

Production: Build and Run

npm run build or vite build
npm run dev

Deployment:

• Frontend Deployment: Vercel or Netlify
• Backend Deployment: Railway, Render or Heroku

Contributing:

1. Fork the repository
2. Clone the repository:

git clone https://github.com/ruthvik-mt/Trackifi.git

cd Trackifi

git remote add upstream https://github.com/ruthvik-mt/Trackifi.git

3. Now, if you run git remote -v you should see two remote repositories named:

• origin (forked repository)
• upstream (Trackifi repository)

License

This project is licensed under the MIT License - see the LICENSE file for more details.

Made with ❤️ using Springboot