Skip to content

michaelsboost/Budjut

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

40 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ’ธ Budjut โ€“ From Budgeting to Financial Progress

Budjut Banner

Budjut is a privacy-first personal finance and budgeting app that helps you track expenses, manage cash flow, build savings, eliminate debt, and measure financial progress. All without subscriptions, accounts, or tracking.

Live Demo MIT License GitHub Stars GitHub Issues

Browser-based โ€ข Offline-friendly โ€ข Privacy-first โ€ข No accounts โ€ข No subscriptions


๐ŸŒŸ Overview

Budjut is a lightweight financial progress app that combines budgeting, expense tracking, savings goals, debt payoff planning, and wealth building tools into a single experience.

Unlike traditional budgeting software that focuses primarily on spending, Budjut emphasizes progress. Whether you're building an emergency fund, paying off debt, saving for a major purchase, or pursuing long-term financial independence, Budjut helps you understand not only where your money goes, but what it's helping you build.

Core Components

  • ๐Ÿ’ฐ Income and expense tracking
  • ๐Ÿ“Š Cash-flow and spending analysis
  • ๐Ÿฆ Goal-based Vaults
  • ๐Ÿ› Financial Foundation framework
  • ๐ŸŽฏ Money Pattern Score
  • ๐Ÿ’ก Smart insights and coaching
  • ๐Ÿ“ˆ Reports and analytics
  • ๐Ÿ”’ Local-first privacy

Everything stays on your device.

No cloud dependency. No accounts. No tracking.


๐Ÿš€ Launch the App

๐ŸŒ Live Version

https://michaelsboost.com/Budjut/

๐Ÿ“ฒ Progressive Web App (PWA)

Install Budjut to your home screen and use it offline anytime.


๐Ÿง  Philosophy

Most financial apps focus on transactions.

Budjut focuses on progress.

Tracking expenses is important, but financial health is built through intentional habits, purposeful saving, debt reduction, and long-term thinking.

Budjut is built around four principles:

  • Clarity โ€” understand your finances at a glance.
  • Ownership โ€” your data belongs to you.
  • Simplicity โ€” powerful tools without unnecessary complexity.
  • Progress โ€” measure what you're building, not merely what you're spending.

โ€œA budget is telling your money where to go instead of wondering where it went.โ€

โ€” Dave Ramsey

Budjut extends that idea:

"Financial progress isn't measured by what you spend, but by what you're building."


๐Ÿ›  Features

๐Ÿ’ฐ Transaction Management

  • Add, edit, and delete income and expense transactions
  • Categorized entries with optional notes
  • Real-time balance and cash-flow calculations

๐Ÿ“Š Money Overview Dashboard

  • Planned vs actual spending
  • Budget left
  • Cash left after expenses
  • Spending flow visualization
  • 50 / 30 / 20 snapshot

๐Ÿฆ Vaults โ€” Goal-Based Saving

Create dedicated vaults for:

Examples
๐Ÿšจ Emergency Fund
๐Ÿ’ณ Debt Snowball
โœˆ๏ธ Vacation
๐Ÿš— New Car
๐Ÿ  Home Down Payment
๐Ÿš€ Business Startup
๐ŸŽ„ Holiday Gifts
๐Ÿ“ฆ Major Purchases

Vaults track:

  • Goal amount
  • Current balance
  • Monthly contributions
  • Progress percentage
  • Estimated completion date
  • Optional emoji/icon

Vaults represent what you're building, not where your money went.

๐Ÿ› Financial Foundation

Stage Objective
Stage 1 Starter Emergency Fund
Stage 2 Eliminate High-Interest Debt
Stage 3 Build 3โ€“12 Months of Expenses
Stage 4 Long-Term Wealth Building

Each stage can be completed manually or automatically based on your financial data.

๐ŸŽฏ Money Pattern Score

Budjut evaluates nine dimensions of financial progress:

Factor Max Points
Cash Flow Momentum 30
Spending Control 25
Savings Power 20
Budget Balance 15
Category Discipline 10
Emergency Fund Progress 15
Debt Reduction Progress 15
Goal Contributions 15
Financial Foundation Progress 15

Total: 160 points, scaled to a score between 0โ€“100.


๐Ÿงฎ Money Pattern Score Ratings

Score Rating
90โ€“100 ๐Ÿ”ฅ Elite
75โ€“89 ๐Ÿ’ช Strong
60โ€“74 ๐Ÿ‘ Stable
40โ€“59 โš ๏ธ Needs Focus
0โ€“39 ๐Ÿšจ At Risk

Budjut also provides:

  • Next Best Move recommendations
  • Personalized insights
  • Progress projections
  • Smart coaching based on your habits

๐Ÿ“ˆ Analytics & Reports

  • Monthly spending trends
  • Category breakdown charts
  • Planned vs actual comparisons
  • Visual progress indicators
  • Trend analysis

๐Ÿ’ฑ Multi-Currency Support

USD โ€ข EUR โ€ข GBP โ€ข JPY โ€ข CAD โ€ข AUD


๐Ÿ“ CSV Import & Export

Export transactions and import them again with validation.

Example

amount,type,category,date,note
850,expense,Rent,2025-01-01,
100,expense,Electric,2025-01-05,
3000,income,Salary,2025-01-01,Monthly paycheck
Column Type Description
amount number Transaction amount
type string income or expense
category string Category name
date string YYYY-MM-DD
note string Optional note

๐Ÿ’พ Local Storage

  • Automatic saving
  • JSON backup and restore
  • No accounts
  • No servers
  • No cloud dependency

๐ŸŽฎ Tips & Shortcuts

Action Method
New transaction Press N
Search Search field
Filter type Dropdown
Edit transaction โœ๏ธ button
Delete transaction ๐Ÿ—‘๏ธ button
Create Vault Vault panel
Toggle Foundation stage Foundation panel
Share summary Share button

๐ŸŽจ Modern Interface

  • Responsive design
  • Glassmorphism cards
  • Dark mode
  • Mobile friendly
  • Smooth animations
  • Coach-like experience

๐Ÿ”’ Privacy First

  • Entirely client-side
  • No analytics
  • No tracking
  • No external requests

Your data stays on your device. Always.


โšก Getting Started

git clone https://github.com/michaelsboost/Budjut.git
cd Budjut
npm install
npm run serve

Open:

index.html

๐Ÿค Contributing

Want to contribute?

  • Fork the repo
  • Create a feature branch (feature-budget-analytics)
  • Submit a pull request ๐ŸŽ‰ and help improve financial accessibility ๐Ÿ’ธ

๐Ÿ“œ License

Licensed under the MIT License โ€” free to use, share, and remix.

Developed by: Michael Schwartz Maintained by: The community

โ˜• Support the Developer

If Budjut was helpful for you, consider supporting future projects:

Your support helps fund future open-source projects and tools for the community ๐Ÿš€