Files
floret-kit/docs
makiolaj 394ac12236 feat(core-android): receiver, permission, alarm and Flow helpers
New Android module (no Compose, no DI) with broadcastTicks, a coroutine
BroadcastReceiver.goAsync, Context.hasPermission, AlarmManager.setWakeup and
Flow.stateWhileSubscribed.
2026-10-15 16:52:14 +02:00
..

floret-kit — documentation

floret-kit is the shared Material 3 Expressive design system + plumbing for the Floret family of Android apps (Calendula, Agendula, Clockula, and future siblings). It is consumed from source as a git submodule + Gradle composite build. See the top-level ../README.md for the pitch.

Index

Doc What it covers
ARCHITECTURE.md How the kit is built and consumed — the module layering, JVM vs Android-library modules, the submodule + composite-build model, and the reproducibility rules. Start here.
ROADMAP.md What's extracted, what's deferred, and what's deliberately not shared — the module status and the divergence decisions from the cross-app survey.
../CONTRIBUTING.md The practical how — adding a module, the no-app-coupling rules, build/test, and how an app adopts the kit.
../CHANGELOG.md Keep a Changelog; what each module added.

The one principle

Share the mechanics, keep the look per-app.

Theme machinery, plumbing, and component primitives are shared; seed colours, palettes, identity chips, and app-specific wording stay in each app. This is what lets the family read as one design language without homogenising apps that are meant to have distinct personalities.