Lukas
Household accounts made clear, no spreadsheets: a household finance app for Colombia, local-first on Android, with a reactive Spring Boot WebFlux backend.
- Role
- Sole author · Product, architecture and development
- Status
- In development
- 14ADRs
- 26Flyway migrations
- 127backend test files
- 155Android unit test files
- Java
- Spring Boot
- WebFlux
- R2DBC
- PostgreSQL
- Redis
- Keycloak
- Kotlin
- Jetpack Compose
- Room
- SQLCipher
- Angular
- Astro
- Docker Compose
Highlights
- Local-first Android app with an encrypted local database (Room + SQLCipher) and offline sync.
- A single sync endpoint with client-generated ids, versioning and visible conflicts.
- Authentication with Keycloak: PKCE on Android and a BFF with an HttpOnly cookie on the web.
- 19 backend E2E tests with Testcontainers (Postgres and Keycloak) and 6 Maestro E2E flows.
Context
Lukas is a household finance app for Colombia: “household accounts made clear, no spreadsheets”. I am its sole author: product, architecture and development.
- Shared households: roles, invite codes and ownership transfer.
- Accounts and movements: cash, savings and Colombian credit cards with handling fees; income, expenses, transfers and splits between members.
- Planning: categories, budgets, recurring payments and expected income.
- Debts and goals: loans and debts, and savings goals with household voting on withdrawals.
- Between members: balances and settlements.
- Offline: offline sync.
Architecture
A reactive modular monolith with hexagonal architecture per feature (ports and adapters inside each feature package). The repository is a monorepo with four apps (android, backend, frontend, landing) plus infrastructure and docs.
- Backend: Java 25, Spring Boot 4.1 with WebFlux, R2DBC on PostgreSQL 18, Redis and Flyway, with S3-compatible storage.
- Security: OAuth2 Resource Server with Keycloak; PKCE on Android and a BFF with an HttpOnly cookie on the web.
- Clients: Android with Kotlin 2.4, Jetpack Compose, Hilt, Room with SQLCipher, WorkManager and Retrofit; Angular 22 on the web; an Astro landing page.
- Sync: one endpoint with client-generated ids, versioning and visible conflicts.
- Operations: Docker Compose and Cloudflare Tunnel.
Decisions are recorded in 14 ADRs: WebFlux with R2DBC, hexagonal per feature, Redis rate limiting and idempotency, S3 storage, Keycloak as resource server, Gitflow with Conventional Commits, local SonarQube with zero issues, a 2-core / 4 GB server budget, data ownership and isolation, secure token handling, local-first sync, staged hosting and a single monorepo.
Engineering and quality
- Backend: 127 test files, 19 of them E2E with Testcontainers (Postgres and Keycloak), and 26 Flyway migrations.
- Android: 155 unit test files, 4 instrumented ones and 6 Maestro E2E flows (plus Robolectric).
- Quality and security: ArchUnit for architecture rules, SonarQube, gitleaks and GitHub Actions.
Status and roadmap
Work in progress: the Android app is at version 0.5.2 and the backend at 0.4.1. The main code is private; the showcase repository (“View code” button) documents architecture, decisions and status.
There is no public demo with a user interface yet: the backend is deployed as an API and demos will be published progressively. AI auto-capture is planned for the future and does not exist yet.