- Spec-driven — every project starts as a written spec + plan in the repo, before any code.
- Contract-first — one schema generates the clients and types, so a polyglot system can't drift.
- Tested & observable — unit/integration tests across backends and web; crash reporting and analytics from day one.
- Build my own tooling — custom CLI/MCP, Mason bricks, agent skills, internal Claude Code plugin, etc. to automate the boring parts and unlock new capabilities.
| Languages | |
| Frontend |  |
| Backend |  |
| Data |  |
| Cloud |  |
| DevOps |    |
| Testing |  |
| Tools |   |
| AI |         |
Time-synced lyrics in a floating overlay that stays on top of any Android app. On Google Play →
- Reads the currently-playing track from any music app through a
NotificationListenerServiceover Android MediaSessions — no per-app integration. - Paints a system overlay over arbitrary foreground apps from a foreground service, bridged to Flutter across custom Method/Event platform channels.
- Time-syncs
.lrcon device (Hive), with Storage Access Framework import and online lyric search as fallback. - Translation runs server-side through a Genkit flow on DeepSeek — with an output validator, App Check, and per-user rate limiting.
One contract, three languages. An OpenAPI 3.1 spec is the single source of truth: the Dart client and the TypeScript functions are both generated from it, and the Kotlin services share the same DTOs — so a polyglot system can't drift. The backend is mid-migration from Firebase Cloud Functions to a self-owned Spring Boot microservices monorepo (Kotlin, Java 25) — its own JWT + refresh-rotation auth service, shared contract libraries, and custom Gradle convention plugins — for cost, control, and owning the runtime end to end.
%%{init: {'theme':'base','themeVariables':{'fontFamily':'ui-monospace, SFMono-Regular, Menlo, monospace','primaryColor':'#161b22','mainBkg':'#161b22','primaryTextColor':'#e6edf3','nodeTextColor':'#e6edf3','primaryBorderColor':'#1D9E75','nodeBorder':'#1D9E75','lineColor':'#5DCAA5','textColor':'#adbac7','clusterBkg':'#0d1117','clusterBorder':'#30363d','edgeLabelBackground':'#0d1117'}}}%%
flowchart TB
subgraph DEV["on device · android (kotlin)"]
direction LR
NL["notification listener<br/>reads any app's MediaSession"]
OV["overlay foreground service<br/>draws over any app"]
PC["method + event channels"]
end
subgraph APP["flutter app"]
direction LR
BLOC["BLoC · go_router"]
HIVE["Hive store<br/>lyrics · settings"]
OBS["Firebase<br/>Crashlytics · Analytics · App Check"]
CLI["generated API client"]
end
subgraph CON["contract · single source of truth"]
SPEC["OpenAPI 3.1<br/>translate · feature flags · version gate"]
end
subgraph FB["backend · firebase (current)"]
direction LR
FN["Cloud Functions<br/>auth + rate-limit middleware"]
GK["Genkit flow<br/>translate + validator"]
FS["Firestore<br/>rate limits · supporters"]
WH["Ko-fi / Afdian webhooks"]
end
subgraph SB["backend · spring boot (in progress)"]
direction LR
CORE["core service"]
AUTH["auth service<br/>JWT + refresh rotation"]
LIBS["shared contract libs"]
end
DS["DeepSeek LLM"]
NL --> PC
OV --- PC
PC --> BLOC
BLOC --> HIVE
BLOC --> OBS
BLOC --> CLI
SPEC -->|codegen| CLI
SPEC -->|codegen| FN
SPEC -.shared DTOs.-> LIBS
CLI -->|HTTPS| FN
CLI -.migrating.-> CORE
FN --> GK
FN --> FS
WH --> FS
GK --> DS
CORE --- LIBS
AUTH --- LIBS
| Repo | Role |
|---|---|
| flutter-floating-lyric-openapi | OpenAPI contract — single source of truth |
| flutter-floating-lyric-pkg-generated-openapi | Generated Dart client package |
| floating-lyric-spring-boot | Spring Boot (Kotlin) microservices backend |
| floating-lyric-web | Next.js marketing site |
flutter/flutter #168005 —
added header & footer slots to the Material NavigationDrawer widget. Merged into
the framework, May 2025.
