Skip to content
Projects

tombadilo-bombadilo/budgero has 58 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-17 00:42 UTC. Last push 2026-11-13.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Local-first, self-hostable, end-to-end encrypted ZBB app

Self-hosted

README.md

Original

Budgero

Budgero is a local-first personal budgeting application: envelope-style budgets, transaction tracking, goals, recurring payments, rules, multi-currency support, and financial analytics. Data lives in SQLite on the client (browser, via WASM) and syncs end-to-end encrypted through a Go backend.

This is Budgero's primary repository. Development, reviews, and merges happen here, and issues and pull requests are welcome — see CONTRIBUTING.md.

Releases

Find version notes and downloads on GitHub Releases. Maintainers: see the release procedure.

License

Budgero is open source under the GNU Affero General Public License, version 3 (AGPL-3.0-only), an OSI-approved license:

  • You may use, study, modify, self-host, and redistribute the software — including commercially.
  • If you offer a modified version to others over a network, you must make your modified source available to them under the same license.

The Python SDK (packages/sdk-python) is separately licensed under MIT so that client applications embedding it are not affected by the AGPL. Releases prior to the relicense were published under FSL-1.1-ALv2.

Repository layout

Package Description
packages/app React frontend (Vite, TailwindCSS, PWA)
packages/core Shared TypeScript domain logic: SQLite schema, migrations, services
packages/runtime Local-first runtime: sync transport, mutation execution, encryption
packages/server Go API server (Echo, SQLite)
packages/website Marketing and documentation site (Next.js)
packages/sdk-python Python SDK for the Push API
packages/eslint-config Shared ESLint configuration

Each package has its own README with details.

Builds

Budgero ships in exactly two flavors:

  • Cloud (SaaS) — the hosted service at budgero.app, built with app.Dockerfile (Clerk authentication, subscriptions).
  • Self-host — a single binary with the frontend embedded, or a Docker image built with selfhost.Dockerfile (local authentication, no cloud dependencies). See docs/selfhost-cli.md.

Development setup

Prerequisites: Node.js 22+, pnpm 11+, Go 1.26+.

pnpm install
pnpm run setup:dev        # one-time setup (package builds, Air for Go hot-reload)

pnpm run dev:selfhost     # frontend + Go backend in self-host mode
pnpm run dev:website      # marketing site (port 3000)

The app is served at http://localhost:5173, the API at http://localhost:3001.

Self-host mode is the flavor that works out of the box. The cloud (SaaS) flavor (pnpm run dev:cloud) requires a Clerk development instance of your own — set VITE_CLERK_PUBLISHABLE_KEY in packages/app/.env.local.

Quality gates

pnpm run type-check:all   # tsc across core, runtime, app
pnpm run lint:app         # eslint (also :core, :runtime, :server)
pnpm run test:core        # domain logic tests (also test:app, test:server)
pnpm run build:all        # full production build
pnpm run security         # osv-scanner + govulncheck

Documentation

Document Topic
docs/selfhost-cli.md Self-host CLI reference
docs/build-flags.md Build and runtime flags
docs/STYLEGUIDE.md Code conventions
docs/data-format-versioning.md Sync wire-format versioning

Support

Supporting the project

Self-hosting Budgero is free, with the full feature set, and always will be. If it saves you money, you can donate — pay what you want — or simply star this repository. Both genuinely help.