Repository navigation
Releases
Releases · BrunoV21/BranchBalance
BranchBalance v1.2.0
Download BranchBalance v1.2.0 for Android. The release includes signed APKs for arm64-v8a and armeabi-v7a devices plus their SHA-256 checksums.
Highlights
- Start from the camera action beside Add expense, then photograph a paper receipt or choose an existing image from Photos.
- Read receipt text entirely on the Android device with bundled PaddleOCR models; receipt images and recognized text are never uploaded for OCR.
- Prefill the normal expense form with a detected merchant, total, and date when confidence is sufficient, and check an explicit receipt currency against the group's currency.
- Review ordinary editable fields before saving, with clear warnings for ambiguous totals, currency mismatches, missing values, and lower-confidence results.
- Retake a receipt or continue with manual entry at any time. Category, payment method, payer, and split remain deliberate user choices.
Upgrade notes
- Existing groups, expenses, settlements, activity, and analytics remain compatible; no repository migration is required.
- OCR models are bundled in the Android APK, so this release is larger than v1.1.0 and does not download a model after installation.
- Receipt capture, image preparation, OCR, parsing, and review work without a network connection. Saving the confirmed expense still requires GitHub connectivity.
- BranchBalance requests camera or photo-library access only when that input is used; manual expense entry remains available without either permission.
Platform and data
- Android remains the supported platform, and this build uses Android version code 3 for in-place upgrades from earlier releases.
- Prepared images live only in a bounded application cache and are deleted after handoff, cancellation, or failure; the original photo remains under Android and user control.
- Receipt pixels, OCR blocks, detected values, and confidence data are not attached to the expense or written to the group's GitHub repository.
- Only the final expense fields explicitly reviewed and saved by the member use the existing GitHub-backed expense workflow.
Known constraints
- OCR accuracy depends on lighting, focus, receipt condition, print quality, and layout. Every detected field must be reviewed before saving.
- The first parser targets common English and Portuguese receipt labels and supports EUR, USD, and GBP currency checks.
- Receipt line items, categories, payment methods, payers, and split choices are not inferred, and BranchBalance does not retain a receipt image with the expense.
- Expo Go cannot run the custom OCR module; receipt scanning requires the packaged Android app or an Expo development build.
BranchBalance v1.1.0
Download BranchBalance v1.1.0 for Android. The release includes the signed BranchBalance-v1.1.0.apk and its SHA-256 checksum.
Highlights
- Record settlement payments made outside BranchBalance, reserve pending amounts, let the recipient confirm receipt, and review or delete payment history with optional shared notes.
- Catch up from Your groups with an on-device activity inbox, unread indicator, explicit or swipe-to-dismiss actions, and Clear all confirmation.
- Understand budget pace with cumulative tracked spending against a clearly labelled Even budget pace reference, without presenting a forecast.
- Explore daily spending, ranked category mix, and Shared versus Just me totals, then drill directly into matching expenses by date, category, or scope.
- Compare each member's Paid and Share values on one scale and keep the expense funding gap distinct from settlement-adjusted net balances.
- Use the same analytics through accessible textual summaries, labelled series, minimum touch targets, light/dark themes, and motion-free charts.
- After inviting a collaborator, see repository-specific guidance asking them to accept at
github.comand refresh Your groups; eligible invitations can also be reviewed in the app when GitHub exposes them to the authenticated GitHub App user token.
Upgrade notes
- Existing v1.0.0 groups and expenses remain compatible; no repository migration is required.
settlements.jsonis created only when the first settlement payment is recorded.- Activity history and read state are stored only on the device and are isolated by signed-in account.
- Analytics are derived locally from the current validated group snapshot and are not persisted to GitHub.
Platform and data
- Android remains the supported platform, and this build uses Android version code 2 for in-place upgrades from v1.0.0.
- Group expenses, plans, and settlement records stay in the group's private GitHub repository.
- BranchBalance adds no application backend, telemetry pipeline, push service, or background synchronization.
Known constraints
- GitHub App user tokens may not expose pending private-repository invitations before acceptance. When an invitation is missing in BranchBalance, accept it on GitHub and refresh Your groups.
- The activity inbox is a best-effort view of changes observed while the app is open or returns to the foreground; it is not push notification delivery or a complete audit log.
- Even budget pace is a reference based on recorded expenses, not a prediction of final trip spending.
- Receipt images, percentage splits, currency conversion, organization-owned groups, and background/offline writes are not included.
BranchBalance v1.0.0
Download BranchBalance v1.0.0 for Android. The release includes the signed BranchBalance-v1.0.0.apk and its SHA-256 checksum.
Highlights
- Create a group as a private
branch-balance-<slug>repository and invite GitHub users as members. - Add, edit, and delete dated expenses with equal, full-to-one, or Just me allocation.
- Derive exact balances and a deterministic settlement list from integer minor-unit shares.
- Plan group spending with optional group and category budgets, payment methods, filters, trip dates, and daily guidance.
- Keep legacy expenses valid with explicit Uncategorized and Unspecified presentation.
- Protect edits and deletes with GitHub blob identifiers so concurrent changes are never overwritten silently.
Platform and data
- Android is the supported platform for this release.
- Group data stays in a private GitHub repository owned by the group creator.
- Reads and writes require a network connection, and one currency is used per group.
Known constraints
- Settlements cannot yet be recorded as paid.
- Receipt images, percentage splits, currency conversion, and push notifications are not included.
- Groups are currently owned by personal GitHub accounts rather than organizations.