Documentation

Know what happens to every cent.

Start using BranchBalance, understand the GitHub-backed model, or explore the decisions behind the open-source app.

Browse 12 guides across four topics.

Getting started

From source checkout to your first private group.

Install and run the previewRequirements, npm setup, Expo, and local development.Configure the GitHub AppDevice flow, permissions, installation coverage, and secrets.Connect an Android deviceRun Metro through USB when the phone cannot reach your Mac.

Using BranchBalance

Common workflows for owners and group members.

Create and invite a groupPrivate repositories, currencies, collaborators, and invitations.Add and split expensesEqual, full-to-one, and Just me expenses explained.Plan and understand spendingBudgets, trip dates, categories, methods, and filters.

Data & ownership

Plain-language answers about trust and control.

How BranchBalance stores your dataWhat lives on GitHub, what stays on-device, and who can see it.Membership and permissionsOwners, accepted collaborators, pending invites, and access.Credential securityRotating GitHub tokens, SecureStore, and safe configuration.

Build & contribute

The product and engineering decisions behind the app.

Architecture guideBoundaries, state, GitHub operations, storage, and compatibility.Testing guideAutomated checks and physical-device acceptance scenarios.Product requirementsPhase 1, spending intelligence, constraints, and acceptance.

Documentation is part of the product

See a gap? Improve it in the open.

The PRD, architecture guide, tests, and implementation live together in the repository so product promises can be checked against the code.

Browse the repository View release status

{ }Source first