Skip to content
Snippets Groups Projects
Name Last commit Last update
financial-tracker
README.md

Personal Finance Tracker

A web-based application that helps users track income, expenses, and financial trends over time. Designed with simplicity and scalability in mind, this app empowers users to gain better control over their personal finances.


📦 Technology Stack

Layer Technology
Frontend React.js
Backend Node.js / Express (TBC)
Database PostgreSQL
API Auth JWT
Dev Tools Docker, GitLab, Git
CI/CD GitLab CI (Planned)

🛠️ Installation Guide

You can run the app in two ways:

  1. Docker Compose
  2. Local Setup

💻 Run Locally (Without Docker)

Make sure you have Node.js and npm installed.


Frontend Setup

git clone https://gitlab.surrey.ac.uk/so00624/personal-finance-tracker.git
cd personal-finance-tracker/frontend
npm install
npm start

---

#### Backend Setup (Coming Soon)
Instructions for backend will be added once implemented.

#### 🚀 Run Using Docker
Requires Docker + Docker Compose installed.
```bash
docker-compose up --build

##This will:
##Build and run the frontend
##Build and run the backend (once ready)
##Link services via Docker Compose

---

📸 Screenshots (Coming Soon)
<!-- Optional: Add screenshots of the running app --> <!

---

🙌 Contributors
Sinead Obeng – User Registration & Authentication etccc
Ebehitale Oaahimijie – README + Feature Implementation etcc 
Chiugo Bede-Alugbue 
Amzat Karim 
Juwon Atiku