Skip to content

πŸ’³ A premium, minimalist expense tracker inspired by Apple & Notion design systems. Features digital envelope budgeting, activity heatmaps, and high-fidelity dark mode analytics. Built with Streamlit & Plotly.

Notifications You must be signed in to change notification settings

AryaBuwa/MySpendly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

19 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’³ Spendly Pro

Personal Finance, Reimagined for Focus.

Launch Live Application β€’ View Repository

Spendly Pro is a high-performance, minimalist expense tracker inspired by the design languages of Apple and Notion. Built on Streamlit, it combines the structural clarity of a digital ledger with the visual depth of modern financial dashboards.


🎨 Design Philosophy

Spendly Pro is built for users who value aesthetics as much as utility.

  • Minimalist UI: A deep-charcoal interface utilizing the Inter typeface for maximum legibility.
  • Tactile Feedback: Notion-style color-coded tags for instant category recognition.
  • Apple-Inspired Alerts: Dynamic status badges that distinguish between "Today" and historical entries.

✨ Key Features

πŸ“Š Intelligent Analytics

  • The Doughnut Allocation: A high-contrast visualization of your spending distribution.
  • Activity Heatmap: A 30-day GitHub-style grid to track spending frequency.
  • Live Metrics: High-level summary cards for Capacity, Expenditure, and Savings.

βš™οΈ Envelope Budgeting

Manage your finances using the digital envelope method. Customize limits for core categories including Food, Rent, Transport, Fun, and Bills.

πŸ“‚ Data Sovereignty

  • Instant Ledger: Fast, responsive logging with a UUID-backed transaction system.
  • CSV Export: One-click download for auditing in Excel or Apple Numbers.
  • Deep Search: A powerful filter to drill down through transactions instantly.

πŸ› οΈ Technical Stack & Installation

Component Technology
Framework Streamlit
Data Engine Pandas
Visualization Plotly (Graph Objects)
Styling Custom CSS3 & HTML Injection

Local Setup:

git clone [https://github.com/AryaBuwa/MySpendly.git](https://github.com/AryaBuwa/MySpendly.git) && cd MySpendly
pip install -r requirements.txt
streamlit run app.py

πŸ“ Changelog & Roadmap

v1.0.0 β€” Current Release

Initial Stable Build

  • Design: Implementation of the Apple/Notion Dark Mode UI using custom CSS injection.
  • Logic: Core "Envelope" budgeting system for categorized financial tracking.
  • Data: Interactive 30-day expenditure heatmap.
  • ID System: UUID-backed transaction logging for precise record management.

Planned Features (Roadmap)

  • Multi-Currency Support: Automatic conversion for international use.
  • Recurring Transactions: Automation for monthly subscriptions and rent.
  • CSV and PDF Summaries: CSV and PDF export functionality with beautifully formatted monthly financial reports for offline storage.
  • Visual Alerts: Notifications when an "Envelope" exceeds 80% of its capacity.


πŸ›‘οΈ Usage Policy & Protection

All Rights Reserved. To ensure the integrity of the project and protect the original work:

  • Personal Use Only: This application is intended for individual financial tracking and educational purposes.
  • No Unauthorized Redistribution: You may fork this repository for personal learning, but you may not re-publish this application under a different name or use it for commercial profit without explicit written permission.
  • No Malicious Use: Any attempt to reverse-engineer the application to inject malicious code or disrupt the hosted service is strictly prohibited.
  • Data Privacy: This app does not store data on a permanent server; all data lives in your browser session. Export your CSV regularly to avoid data loss.

Caution

Disclaimer: The author is not responsible for any financial decisions made based on the data provided by this app. Use at your own risk.


About

πŸ’³ A premium, minimalist expense tracker inspired by Apple & Notion design systems. Features digital envelope budgeting, activity heatmaps, and high-fidelity dark mode analytics. Built with Streamlit & Plotly.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages