UrBudget

A private envelope budget for Windows, macOS, iPhone, iPad and Android. The apps are free and open source under the GNU AGPL v3; the only paid part is optional end-to-end encrypted sync through urbudget.app, $3 a month. One Rust engine does the accounting everywhere; each app draws its own interface.

Folder	What it is
desktop/	The Windows and macOS app: Tauri, with a React window
ios/	The iPhone and iPad app: SwiftUI, an Xcode project
android/	The Android app: Kotlin and Jetpack Compose, a Gradle project
crates/	The shared Rust engine. urbudget-core does the accounting, SQLite storage, imports, reports and sync merges; urbudget-services the account, encrypted sync, sealed vault, bank and YNAB connections and the assistant. urbudget-ios and urbudget-android let the phone apps call them
shared/	Kotlin for Android's Keystore and Google Play billing, and test fixtures
web/	The website and API at urbudget.app (one Cloudflare Worker): accounts, the sync subscription, sync storage
scripts/	Repository tools, such as versions.mjs for each app's version
docs/	Guides, release status and history

desktop/   React window  -> Tauri commands ----------+
ios/       SwiftUI screens -> crates/urbudget-ios ----+--> crates/urbudget-services
android/   Compose screens -> crates/urbudget-android +    crates/urbudget-core

The mobile guide explains how the phone apps build the Rust engine into themselves and where their code is. Desktop, Android and iOS each have their own version, tag and release workflow: see RELEASING.md. Start with the documentation index for everything else.

To run the desktop app:

cd desktop
npm ci
npm run desktop

For the phone apps, open ios/UrBudget.xcodeproj in Xcode or the android/ folder in Android Studio and run; each README lists what to install first.

Private YNAB exports, migration-* fixtures and local reports/ evidence are not application assets or source documentation. See artifact retention before cleaning them.

License

Copyright (C) 2026 Ahmad Horanieh.

UrBudget is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Running a modified version for others over a network means offering them its source, as the license's section 13 describes.

"UrBudget" and its icon identify the official apps and urbudget.app; forks should use their own name.