Skip to content
BrunoArroyoCPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ZenLedger logo: a white brush-drawn ensō on black

ZenLedger

Calm, private money management for your desktop.
Your accounts, budgets, goals and savings, painted on a black canvas, stored only on your own machine.

Tauri 2 React 19 SQLite Platforms Status License: MIT

Download · Features · Build from source · Roadmap


ZenLedger overview: the account deck, overall balance, this month's money in and out, a savings goal, the emergency fund and spending against budgets

Why ZenLedger

Most finance apps want your bank login, your data in their cloud, and your attention. ZenLedger asks for none of that.

  • Your data never leaves your computer. Everything lives in one SQLite file on your machine. No account to create online, no sync server, no analytics.
  • One glance answers "where do I stand?" One big number for what you have minus what you owe. Under it, only what needs attention: a goal falling behind, a budget close to its limit, how many months your emergency fund covers.
  • Numbers you can trust. Every balance updates the moment you record money, you see the before → after before you save, and transfers between your own accounts never count as spending.

What it does

🎨 Every account is a painted card

Debit, credit, cash and savings accounts each get their own oil-paint pigment, and that colour follows the account everywhere: its card, its dot in the ledger, its bars and lines. Pick a card and the whole dashboard repaints around that account. The white All accounts card shows the full picture: debit + cash + savings − credit debt.

💸 Money in, money out, and money moved

  • Record income and expenses in seconds; the amount leads, categories are one tap.
  • Transfers between your own accounts (paying a credit card, moving money into savings) update both balances and are never counted as income or spending.
  • Repeating transactions (salary, rent, Netflix, a monthly savings deposit) are added on their own day, including the ones that came due while the app was closed. A notice tells you what was added.
  • Edit or delete anything; you always see what it does to your balances first.
A transfer from a debit card to a credit card, with both balances before and after An expense that would go over the Groceries budget asks for approval first
Transfers show both balances before → after Going over a budget asks for your approval first

📊 Budgets that keep you honest

  • A monthly limit per category, across every account. Repeating budgets roll into each new month on their own.
  • Rollover: what you didn't spend last month is added to this month, and what you overspent is taken off.
  • Gentle alerts: amber at 80%, red only when you're actually over. Before you record an expense that breaks a budget, ZenLedger asks you to approve it.
  • A Budgets screen to step through months, edit limits, and spot spending that has no budget yet.

The Budgets screen: this month's spending against each budget, with rollover and alerts

🎯 Goals with a plan

Save toward something with a price and a date. ZenLedger suggests the monthly amount that gets you there, shows what share of your salary it takes, and tells you plainly whether you're on track. Fund a goal with a transfer, or make it automatic with a repeating one. Pause, finish or reopen goals any time.

The Goals screen: active goals with progress, status, money left to save and the suggested monthly amount

🌱 Watch your savings grow

Select a savings account to see where it's heading in 1, 3 or 5 years: its own interest rate, paid monthly, plus your repeating deposits. Try a different monthly amount and watch the line move. It's a forecast only; nothing is recorded until it really happens.

A savings account's growth chart: balance, deposits and interest over one year

🛟 An emergency fund measured in months

Set an account aside for the unexpected and mark the categories you couldn't skip in a bad month. ZenLedger turns that into the question that matters: how many months would this cover? Taking money out of the fund asks you to approve it first, showing the months covered before → after.


Download

Installers for every platform are on the Releases page:

Platform File Notes
Ubuntu / Debian .deb Ubuntu 22.04 or newer
Fedora / openSUSE .rpm
Any Linux .AppImage Make it executable, then double-click
Windows 10/11 .msi or .exe
macOS .dmg aarch64 for Apple Silicon, x64 for Intel

Note

The builds are not code-signed yet. On Windows, SmartScreen may say "unknown publisher": choose More info → Run anyway. On macOS, right-click the app and choose Open the first time.


Your data, your machine

ZenLedger keeps everything in a single SQLite file in your user folder:

OS Location
Linux ~/.config/com.zenledger.app/local.db
Windows %APPDATA%\com.zenledger.app\local.db
macOS ~/Library/Application Support/com.zenledger.app/local.db
  • Passwords are hashed with Argon2id; only the hash is stored.
  • Your session lives in memory, so closing the app logs you out.
  • Back it up by copying that file while the app is closed.

Warning

There is no password reset in v0. If you forget your password, there's no way back into your data yet. An offline recovery key is planned for v1. Until then, keep your password somewhere safe.


Build from source

You'll need Bun, Rust and Tauri's system prerequisites for your OS. On Ubuntu:

sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

Then:

git clone https://github.com/BrunoArroyoC/Zenledger.git
cd Zenledger
bun install

bunx tauri dev      # run the desktop app with hot reload
bunx tauri build    # build installers into src-tauri/target/release/bundle/

Each OS builds its own installers. The Release workflow builds Linux, Windows and macOS on GitHub Actions whenever a v* tag is pushed.

Working on the UI without Tauri

bun run dev
# open http://localhost:5173/?preview=dashboard

In a plain browser, ZenLedger swaps in an in-memory SQLite (sql.js) and signs in a preview user, so the real service layer, validation and constraints all run. It starts empty on every reload. node scripts/screenshot.mjs captures every screen with demo data at 800×600 and 1440×900.

Checks

bunx tsc --noEmit        # types
bun run build            # production web build
bunx drizzle-kit check   # schema and migrations agree

How it's built

Layer Tools
Desktop shell Tauri 2 (Rust), SQL plugin for SQLite
Interface React 19, Vite, Tailwind CSS 4, Base UI / shadcn, Motion, GSAP
Data SQLite + Drizzle ORM, migrations applied at startup
State TanStack Query (database reads), TanStack Store (session)
Validation Zod schemas generated from the Drizzle tables
Auth Argon2id via hash-wasm
src/
├── screens/          Overview, Transactions, Budgets, Goals
├── components/       dashboard panels, dialogs and forms
├── hooks/            TanStack Query over the service layer
├── logic/
│   ├── serviceLayer/ every database read and write (validated, scoped to the user)
│   ├── ledger/       the money rules: balances, budgets, goals, emergency fund
│   ├── utils-logic/  small pure helpers: projections, months, previews
│   └── models/       Zod validation schemas
└── db/               Drizzle schema and the boot-time migrator
drizzle/              generated SQL migrations
src-tauri/            the Rust/Tauri shell and app icons

A few rules the code follows:

  • No money math in components. Every number on screen comes from src/logic/.
  • Computed when read, never stored: spent, saved, rollover, projections, months covered. The only stored total is each account's balance, kept in sync by the transaction layer.
  • Transfers are never income or expense.

The visual language is called "The Painted Canvas": a true-black ground, oil paint only at the window's edges, numbers on dark glass, one pigment per account, and red reserved for money actually overspent.


Roadmap

v0 (now): accounts, transactions, transfers, repeats, budgets with rollover and alerts, goals, savings growth and the emergency fund.

v1 (next):

  • 📈 Investments: positions, profit and loss, live prices
  • 🔑 Account recovery: an offline recovery key
  • 💱 Multi-currency: amounts converted to your base currency on screen
  • 📉 Inflation in savings projections
  • 🧭 Smarter links between budgets, the emergency fund and investments

License

ZenLedger is open source under the MIT License. Use it, change it, share it; just keep the copyright notice.


Made by Bruno Arroyo del Castillo · ZenLedger keeps your money where your data is: with you.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages