Skip to content
Julián Bayer//
Back to projects
// In development

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.