Skip to content

Home

Jump to bottom
Collins Dada edited this page Apr 22, 2025 · 2 revisions

Expense Tracker Wiki

Welcome to the Expense Tracker wiki — your go-to manual for everything under the hood. This project doesn’t just track expenses; it prevents against financial doom and puts your financial life back in check with clean, modular, and uniquely written Python code and a slick Streamlit user interface.

Overview

Expense Tracker is a personal finance app built by students, for students (and anyone else tired of wondering where their money went). The design is intentional: simple inputs, real-time analysis, and a killer backend. All data stays local by default — because privacy shouldn’t be a premium feature.

Project Structure

Expense-Tracker/
├── app.py                # Main Streamlit application
├── backend/
│   ├── data_handler.py   # Core functions for adding/filtering data
│   ├── storage.py        # Local storage interface (JSON-based)
├── frontend/
│   ├── ui_components.py  # Custom Streamlit UI modules
│   └── visualizer.py     # Handles Plotly & Matplotlib charts
├── data/
│   └── expenses.json     # Local database (JSON file)
├── README.md
├── requirements.txt

How to Run

# 1. Clone the repo
git clone https://github.com/Contractor-x/Expense-Tracker.git
cd Expense-Tracker

# 2. Install requirements
pip install -r requirements.txt

# 3. Launch the app
streamlit run app.py

Philosophy: Fintech for the People

We’re anti-bloat focused. This app is minimal by design. It’s built on:

  • Transparency (open-source code, visible data files)
  • Control (no APIs unless you plug them in)
  • Performance (lightweight dependencies)

Every feature is engineered with purpose. If it doesn’t serve the user, it doesn’t sell.

Core Features

  • Add income and expense records
  • Filter transactions by date, category, and tags
  • Visualize cash flow with charts (Pie, Bar, Line)
  • Summarized monthly reports with reactivity
  • Zero cloud dependency (unless extended by user's request)

Contributions

We move like a startup and document like a dev team. You’re welcome to contribute:

  1. Fork it
  2. Branch it
  3. Build it
  4. PR it

Issues and feature requests are handled weekly. Join the mission and see the vision.

Maintainers

License

MIT License © Expense Tracker 2025

Final Words

This isn’t a budget app. It’s a mission tool. Track your flow, analyze patterns, and stay in control — no subscriptions, no gimmicks. Let’s build the future of personal finance, one line of code at a time.

Clone this wiki locally