Skip to content

About

Personal finance tracking for India: Expo SDK 58 for Android, iOS and web

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

finance-bro

Next: the 2.0 roadmap is narrowed to opt-in automatic Android SMS import. Android runtime, privacy, correction-safety and device proof are release gates; iOS, Gmail, receipt OCR, encrypted recovery and planning features are later work.

Finance Bro is the working product name; a final name is not selected.

CI

A mobile-first personal finance app for India, targeting Android, iOS, and web, with English and INR as initial defaults. Suvo and Rohan are building it together.

Status: Early development. Connected Home, manual entry/corrections, paste review/save, Budgets/Bills, Insights and Settings use the shared local ledger. Android/web CSV destinations are connected. Automatic Android SMS import is planned as the sole 2.0 capability and remains unimplemented; iOS export and imports are separate later work. See the UI validation record and data contract for observed checks and remaining gaps.

A frozen install, pnpm check (including 31 parser tests), Expo install check, Expo Doctor (20/20), and Android/iOS/web export passed locally. Browser rendering showed Home and four tab items; Home-to-Settings navigation and one synthetic SMS parse were observed. The other tabs have not had a full click-through. These starter checks are historical; later Android checks are recorded in UI validation. Remote CI and CodeQL results are published on pull requests; use those checks for the current revision. pnpm audit reported three transitive development/build-tool advisories (two high, one moderate); see Security.

Expo SDK 58 is beta and React Native 0.88 is a release candidate. Dependency versions are pinned in pnpm-lock.yaml. TypeScript 6.0.3 and ESLint 9.39.5 remain the current Expo-tooling-compatible versions. One upstream Worklets peer-range warning is still under review; see issue #3.

Install

Use Node.js 22.13 or newer in the 22.x line (the package also accepts Node 24.3+, 26.x, and 27+) and the repository-pinned pnpm 12.9.1:

corepack enable
pnpm install --frozen-lockfile

Run

The mobile app starts in development-client mode. Install a matching Android or iOS development build first; see Contributing for EAS setup.

pnpm build:android:dev  # or pnpm build:ios:dev
pnpm dev

To run the web app:

pnpm web

The SDK 58 beta needs a compatible Expo Go or development client. For a physical iPhone, the beta's EAS Go path uses TestFlight and requires an active Apple Developer Program membership. Scoped Android device results are recorded in UI validation; iOS verification remains outstanding. See Expo's SDK 58 beta guide and iOS device setup.

Check and build

pnpm check
pnpm build
pnpm parser:try "Rs.450 debited from A/c XX1234 to VPA shop@ybl" --sender VM-HDFCBK-S

pnpm check runs type checking, lint, and tests. pnpm build exports Android, iOS, and web bundles; it does not install or verify a native app. Use only fictional or anonymized message text in parser examples and tests.

Product scope

The core finance scope is expenses and income, budgets, and bills. Manual entry and paste review are current entry paths. Automatic Android SMS import is the only new input source selected for 2.0; it is not implemented yet. Receipt scanning/OCR, connected email and iOS imports are later work. Budgets and bills remain part of the product regardless of their order in the preserved Rohan proposal.

The app is local-only, with no app account or hosted backend. Android SMS import needs native integration and explicit, revocable permission; background TypeScript parsing and SQLite writes must be proven under issue #16. A cancellable preview precedes any 90-day history import, and catch-up must use bounded batches. There is no notification-listener fallback. iOS imports, receipt OCR, email and full encrypted backup/recovery are later work. F-Droid permission and source-build eligibility are tracked separately under issue #27; signing and publication remain separate decisions.

The original Rohan plan is preserved in docs/proposals/2026-10-06-rohan-plan.md for reference. PRODUCT.md records the current confirmed scope.

The agreed MVP roadmap sequences a manual-first local ledger, budgets, bills, reviewed paste import and CSV export. Rohan handles design. Automatic SMS experiments run alongside ledger work; native imports do not block the first usable MVP.

Work with the maintainers

Use dev as the integration branch and main for stable releases. The GitHub default branch is dev; see the branching guide. Read Contributing and Security before contributing. No open-source license has been chosen yet.

Repository layout

  • apps/mobile/ — Expo app
  • packages/sms-parser/ — deterministic SMS normalization, classification, and transaction extraction
  • packages/config/ — shared TypeScript configuration

About

Personal finance tracking for India: Expo SDK 58 for Android, iOS and web

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages