{"id":51658221,"url":"https://github.com/simplesuite/simplebudget","last_synced_at":"2026-07-14T12:58:27.853Z","repository":{"id":358688493,"uuid":"1242553402","full_name":"simplesuite/simplebudget","owner":"simplesuite","description":"A simple, self-hostable budgeting app built with React, TypeScript, and Supabase. Track expenses, share budgets, and manage your money.","archived":false,"fork":false,"pushed_at":"2026-07-10T17:42:28.000Z","size":5636,"stargazers_count":19,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-07-14T12:58:02.353Z","etag":null,"topics":["budget","budget-app","budgeting","docker","expense-tracker","finance","money","money-management","open-source","personal-finance","progressive-web-app","pwa","react","self-hosted","supabase","typescript"],"latest_commit_sha":null,"homepage":"https://budget.simplesuite.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simplesuite.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-18T14:28:59.000Z","updated_at":"2026-07-14T06:46:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/simplesuite/simplebudget","commit_stats":null,"previous_names":["simplebudgets/simplebudget","simplesuite/simplebudget"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/simplesuite/simplebudget","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplesuite%2Fsimplebudget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplesuite%2Fsimplebudget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplesuite%2Fsimplebudget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplesuite%2Fsimplebudget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simplesuite","download_url":"https://codeload.github.com/simplesuite/simplebudget/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplesuite%2Fsimplebudget/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35462449,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-14T02:00:06.603Z","response_time":114,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["budget","budget-app","budgeting","docker","expense-tracker","finance","money","money-management","open-source","personal-finance","progressive-web-app","pwa","react","self-hosted","supabase","typescript"],"created_at":"2026-07-14T12:58:23.068Z","updated_at":"2026-07-14T12:58:27.836Z","avatar_url":"https://github.com/simplesuite.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"public/simplebudget.png\" alt=\"simpleBudget screenshot\" width=\"250\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003esimpleBudget\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  A simple, open-source budgeting app built with React, TypeScript, and Supabase. Track expenses, share budgets, and manage your money.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/simplesuite/simplebudget/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/simplesuite/simplebudget\" alt=\"License\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/simplesuite/simplebudget/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/simplesuite/simplebudget\" alt=\"Stars\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/simplesuite/simplebudget/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/simplesuite/simplebudget\" alt=\"Issues\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://supabase.com\"\u003e\u003cimg src=\"https://supabase.com/badge-made-with-supabase.svg\" alt=\"Made with Supabase\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## What is simpleBudget?\n\nsimpleBudget is a free, open-source alternative to EveryDollar and YNAB for personal budgeting. It's a mobile-first progressive web app (PWA) you can install on iOS, Android, or desktop — or self-host with Docker.\n\nBuilt for people who want a straightforward way to manage their money without subscriptions or ads.\n\n## Features\n\n- **Multiple budgets** — Create and switch between separate budgets\n- **Sections \u0026 categories** — Organize spending however you want\n- **Transaction tracking** — Log income and expenses with split-transaction support\n- **Budget sharing** — Share budgets with other users via QR code\n- **Analytics** — Pie charts for income and expense breakdown\n- **Copy budgets** — Duplicate a month's budget outline to another month\n- **CSV export** — Download your data anytime\n- **Notifications** — Daily browser reminders for upcoming transactions\n- **Dark \u0026 light mode** — Respects your preference\n- **Offline support** — Works without internet, syncs when reconnected\n- **Installable PWA** — Add to home screen on any device\n- **Self-hostable** — Run on your own server via [simplesuite-selfhost](https://github.com/simplesuite/simplesuite-selfhost)\n\n## Screenshots\n\n### Budget \u0026 Transactions\n\n| Budget page | Transactions | Search transactions |\n|:-:|:-:|:-:|\n| ![Budget page](readme_assets/budget_page.png) | ![Transactions page](readme_assets/transactions_page.png) | ![Transactions search](readme_assets/transactions_search.png) |\n\n| Edit category | Category helpers | View category (expense) |\n|:-:|:-:|:-:|\n| ![Edit category](readme_assets/edit_category.png) | ![Edit category helpers](readme_assets/edit_category_helpers.png) | ![View category expense](readme_assets/view_category_expense.png) |\n\n### Analytics\n\n| Budget vs Spent | Expense distribution | Income distribution |\n|:-:|:-:|:-:|\n| ![Budget vs Spent](readme_assets/analytics_budget_v_spent.png) | ![Expense distribution](readme_assets/analytics_expense_dist.png) | ![Income distribution](readme_assets/analytics_income_dist.png) |\n\n### Sharing \u0026 Export\n\n| Share budget | QR code | Export CSV |\n|:-:|:-:|:-:|\n| ![Sharing input](readme_assets/sharing_input.png) | ![Sharing QR code](readme_assets/sharing_qr_code.png) | ![Export CSV](readme_assets/export_csv.png) |\n\n## Data notice\n\nYour data is protected by RLS policies within Supabase. Only you and those you share it with can view it.\n\nYour data will never be sold, marketed, given away, whatever. It STAYS in simpleTracker and will never leave. If you are extra concerned about data privacy / security, please self-host the backend - and the front end if you want.\n\n## Background of this Project / Disclaimers\n\nThis has thus far been a solo project. I started this in 2022 and using all traditional development. I have only used AI for some small features this year. 95% of the code was written by me.\n\nI did NOT make this to make money. Hear me - I made this to have an easy to use budgeting app.\n\nThe subscription model is ONLY there to cover hosting fees from supabase and vercel. If you self-host the backend, everything is free - FOREVER.\n\nI really like a few of the big budgeting apps (EveryDollar and YNAB specifically) but everything I've tried is either too complicated for me to keep up with, or too simple to be functional. I also want full control of my data. And I don't have the discipline for the bank-connected apps to actually help me - I want it manual.\n\nSo, I took my favorite budgeting apps, pared them down, smooshed them together, and tried to keep it simple. I call it simpleBudget.\n\nFrom there, I went through and added some nice-to-have features.\n\nYou may notice there aren't any issues in here. Feel free to add some if you wish. I just typically keep my list elsewhere. If people start actually using this, I will transfer to issues for tracking.\n\n## An Open-Source Alternative To\n\n- EveryDollar\n- YNAB (You Need a Budget)\n- Mint\n- Goodbudget\n- Copilot Money\n\n## Tech Stack\n\n| Layer | Technology |\n|-------|-----------|\n| Frontend | React 19, TypeScript, Vite |\n| UI | MUI 7 (Material UI) |\n| State | Zustand |\n| Backend | Supabase (auth, database, real-time) |\n| Routing | react-router-dom v7 |\n| PWA | vite-plugin-pwa |\n| Testing | Vitest |\n| Deployment | Vercel |\n\n## Getting Started\n\n### Quick Start (Development)\n\n```bash\n# Clone the repo\ngit clone https://github.com/simplesuite/simplebudget.git\ncd simplebudget\n\n# Install dependencies\nnpm install\n\n# Start dev server (http://localhost:3000)\nnpm run dev\n```\n\n## Self-Hosting\n\nTo self-host simpleBudget (along with the other simpleSuite apps and the Supabase backend), see the **[simplesuite-selfhost](https://github.com/simplesuite/simplesuite-selfhost)** repository. It has everything needed to run each frontend and the backend on your own infrastructure.\n\n### Environment Variables\n\nThe app works out of the box with the default Supabase project. To connect your own:\n\n```bash\ncp .env.example .env.local\n```\n\nSet `VITE_SUPABASE_URL` and `VITE_SUPABASE_KEY` in `.env.local`.\n\n## Project Structure\n\n```\nsrc/\n├── components/\n│   ├── modals/          # Dialog components (AddTransaction, EditCategory, etc.)\n│   ├── subcomponents/   # Shared UI (AppToolbar, BudgetSection, etc.)\n│   └── extras/          # Utilities (api_functions, GrabBudgetData, etc.)\n├── store/               # Zustand stores (globalStore, tableStore, notificationStore)\n├── lib/                 # Supabase client, notifications, offline sync\n└── test/                # Unit tests\n```\n\n## Scripts\n\n| Command | Description |\n|---------|-------------|\n| `npm run dev` | Start development server |\n| `npm run build` | Production build |\n| `npm run preview` | Preview production build locally |\n| `npm test` | Run unit tests |\n\n## Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\nThis project is licensed under the [GNU AGPL v3](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplesuite%2Fsimplebudget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimplesuite%2Fsimplebudget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplesuite%2Fsimplebudget/lists"}