How bluebikebase-inc/kmp-application-foundation works
Foundation is a Kotlin multiplatform application and UI framework, with a localization feature and a web Gradle plugin that generates an HTML entry page. The documented user-facing flow is application lifecycle initialization, view registration and composable rendering, then start/stop/destroy. Core supplies feature registration and lifecycle control; UI supplies renderable views, containers and presentation layers. The README describes the UI lifecycle, while source excerpts and the SOURCE INDEX support the shown calls; links for unsampled subsystems are omitted where their wiring is not evidenced.
Main entry points: ViewLayer.kt View Layer · Application.kt Application · GenerateTemplateTask.kt Template Task · LifecycleController.kt Lifecycle Controller
Components 24
Application Core
- Application
core/src/commonMain/kotlin/org/b3/foundation/application/Application.kt - Feature Contracts
core/src/commonMain/kotlin/org/b3/foundation/application/Feature.kt - Feature Key
core/src/commonMain/kotlin/org/b3/foundation/application/FeatureKey.kt - Feature Registry
core/src/commonMain/kotlin/org/b3/foundation/application/FeatureRegistry.kt - Lifecycle API
core/src/commonMain/kotlin/org/b3/foundation/runtime/Lifecycle.kt - Lifecycle Controller
core/src/commonMain/kotlin/org/b3/foundation/runtime/LifecycleController.kt
UI Runtime
- UI Application
ui/src/commonMain/kotlin/org/b3/foundation/ui/UiApplication.kt - UI Configuration
ui/src/commonMain/kotlin/org/b3/foundation/ui/UiConfiguration.kt - Lifecycle Binding
ui/src/commonMain/kotlin/org/b3/foundation/ui/runtime/BindLifecycle.kt - View
ui/src/commonMain/kotlin/org/b3/foundation/ui/view/View.kt - View Layer
ui/src/commonMain/kotlin/org/b3/foundation/ui/view/ViewLayer.kt - UI Containers
ui/src/commonMain/kotlin/org/b3/foundation/ui/container/Container.kt - Theme Layer
ui/src/commonMain/kotlin/org/b3/foundation/ui/theme/MaterialThemeLayer.kt - Surface Layer
ui/src/commonMain/kotlin/org/b3/foundation/ui/surface/SurfaceLayer.kt - Localization Layer
ui/src/commonMain/kotlin/org/b3/foundation/ui/localization/LocalizationLayer.kt
Localization
- Localization Feature
feature/localization/src/commonMain/kotlin/org/b3/foundation/localization/Localization.kt - Localization Service
feature/localization/src/commonMain/kotlin/org/b3/foundation/localization/LocalizationService.kt - Language State
feature/localization/src/commonMain/kotlin/org/b3/foundation/localization/LocalizationState.kt
Web Plugin
- Web Plugin
plugins/web/src/main/kotlin/org/b3/foundation/plugin/web/B3WebPlugin.kt - Template Task
plugins/web/src/main/kotlin/org/b3/foundation/plugin/web/GenerateTemplateTask.kt - Web Page Config
plugins/web/src/main/kotlin/org/b3/foundation/plugin/web/template/WebPageConfig.kt - HTML Generator
plugins/web/src/main/kotlin/org/b3/foundation/plugin/web/template/IndexHtml.kt
Other components
- Application Developer
- JVM / Wasm Host
Connections 22
- Application Developer → Application: configures
- Application → Feature Registry: registers features
core/src/commonMain/kotlin/org/b3/foundation/application/Application.kt - Feature Registry → Feature Key: keys entries
core/src/commonMain/kotlin/org/b3/foundation/application/FeatureRegistry.kt - Feature Contracts → Feature Key: declares key
core/src/commonMain/kotlin/org/b3/foundation/application/Feature.kt - Application → Lifecycle API: implements
core/src/commonMain/kotlin/org/b3/foundation/application/Application.kt - Lifecycle Controller → Lifecycle API: dispatches callbacks
core/src/commonMain/kotlin/org/b3/foundation/runtime/LifecycleController.kt - JVM / Wasm Host → Lifecycle Controller: drives lifecycle
- Lifecycle Binding → Lifecycle Controller: starts and stops
ui/src/commonMain/kotlin/org/b3/foundation/ui/runtime/BindLifecycle.kt - UI Application → Application: extends
ui/src/commonMain/kotlin/org/b3/foundation/ui/UiApplication.kt - UI Application → View: renders
ui/src/commonMain/kotlin/org/b3/foundation/ui/UiApplication.kt - View Layer → View: renders children
ui/src/commonMain/kotlin/org/b3/foundation/ui/view/ViewLayer.kt - UI Containers → View Layer: implements layer
ui/src/commonMain/kotlin/org/b3/foundation/ui/container/Container.kt - Theme Layer → View Layer: wraps rendering
ui/src/commonMain/kotlin/org/b3/foundation/ui/theme/MaterialThemeLayer.kt - Surface Layer → View Layer: wraps rendering
ui/src/commonMain/kotlin/org/b3/foundation/ui/surface/SurfaceLayer.kt - Localization Layer → View Layer: wraps rendering
ui/src/commonMain/kotlin/org/b3/foundation/ui/localization/LocalizationLayer.kt - Localization Layer → Language State: reads language
ui/src/commonMain/kotlin/org/b3/foundation/ui/localization/LocalizationLayer.kt - Localization Feature → Localization Service: creates service
feature/localization/src/commonMain/kotlin/org/b3/foundation/localization/Localization.kt - Localization Service → Language State: holds state
feature/localization/src/commonMain/kotlin/org/b3/foundation/localization/LocalizationService.kt - Web Plugin → Template Task: registers task
plugins/web/src/main/kotlin/org/b3/foundation/plugin/web/B3WebPlugin.kt - Template Task → HTML Generator: generates page
plugins/web/src/main/kotlin/org/b3/foundation/plugin/web/GenerateTemplateTask.kt - Template Task → Web Page Config: uses config
plugins/web/src/main/kotlin/org/b3/foundation/plugin/web/GenerateTemplateTask.kt - HTML Generator → Web Page Config: reads settings
plugins/web/src/main/kotlin/org/b3/foundation/plugin/web/template/IndexHtml.kt