Adaptive UI primitives and responsive patterns for admin, productivity, and data-heavy interfaces: breakpoints, adaptive layouts/grids, navigation scaffolds, tables-to-cards, form sections, feedback states, and polished components.
AdaptiveKt is an alpha-stage Kotlin and Compose Multiplatform library for building responsive admin, productivity, and data-heavy interfaces from shared UI code. It focuses on the unglamorous but expensive parts of real app UI: layout breakpoints, dashboard shells, tables that become mobile cards, form sections, feedback states, navigation patterns, and reusable component defaults that look professional without requiring every call site to carry a wall of modifiers.
The project is published to Maven Central as 0.1.0-alpha01. It is usable for experimentation, demos, internal tools, and early integration feedback, but it is not a stable 1.0 API yet. APIs may change before beta/stable releases as the library hardens.
Why AdaptiveKt?
Compose Multiplatform makes it possible to share UI across platforms, but teams still need to solve responsive product UI patterns themselves. A simple admin screen often needs breakpoint rules, navigation mode changes, mobile-friendly data cards, clean action states, form layout decisions, empty/loading/error states, and consistent theme tokens.
AdaptiveKt exists to reduce that friction for Kotlin Multiplatform developers. Its direction is commonMain-first: shared primitives should work across Desktop/JVM, Android, Web/Wasm, and iOS where the underlying Compose Multiplatform tooling supports them.
This is not a replacement for Material, nor a claim to be a complete enterprise design system. AdaptiveKt is a focused toolkit for adaptive app patterns that can complement a product's own brand and component layer.
What It Includes
The repository also contains a docs-site and admin demo used to exercise the library visually. Those demo modules are not Maven artifacts.
var status by remember { mutableStateOf<String?>(null) }
AdaptiveSelect(
options = listOf("Open", "Pending", "Closed"),
selectedOption = status,
onSelectedOptionChange = { status = it },
optionLabel = { it },
label = "Status",
searchable = true,
clearable = true,
)
Platform Support
Platform
Status
Desktop/JVM
Library and admin demo build/run on JVM.
AdaptiveKt is designed for Compose Multiplatform commonMain usage. Platform-specific screenshot tooling, Robot/AWT capture helpers, and demo image loading stay outside the library modules.
How to prepare Pages locally:
The GitHub Pages deployment merges Wasm distributions across modules into a single site-dist envelope.
To build and stage this locally without committing the binary artifacts (which are git-ignored):
.\tools\prepare-pages-site.ps1
Project Status
Current published version: 0.1.0-alpha01.
AdaptiveKt is alpha software. The current focus is to validate the API surface, improve documentation and examples, harden accessibility and keyboard/focus behavior, expand visual regression coverage, and gather feedback before stabilizing a beta API.
Why This Matters For The Kotlin Ecosystem
Kotlin Multiplatform adoption improves when developers can see credible paths for real user interfaces, not only small samples. AdaptiveKt targets a practical gap: shared responsive UI patterns for dashboards, internal tools, data workflows, and product admin screens.
The project can help:
Kotlin Multiplatform developers prototype and ship shared UI faster.
Compose Multiplatform adopters evaluate desktop, Android, Web/Wasm, and iOS UI from one codebase.
Students, indie developers, and small teams learn commonMain-first UI architecture.
Internal tool builders avoid rebuilding the same admin patterns from scratch.
Roadmap
Short-term alpha hardening:
Stabilize core public APIs and document migration rules.
Improve accessibility, keyboard navigation, focus, and pointer behavior.
Expand visual regression and screenshot testing across Desktop and Web/Wasm.
Add richer examples for admin, productivity, and ecommerce-style workflows.
Validate iOS artifacts and demos on macOS.
Continue theme/token work for light and dark modes.
Build a contributor feedback loop through issues, templates, and documented governance.
Contributions, bug reports, docs improvements, and API feedback are welcome. Start with CONTRIBUTING.md, and please keep changes commonMain-first unless a platform-specific boundary is intentional and documented.
Security
See SECURITY.md for supported versions and private vulnerability reporting guidance.
Code Of Conduct
AdaptiveKt follows a contributor code of conduct. See CODE_OF_CONDUCT.md.
License
AdaptiveKt is licensed under the Apache License 2.0. See LICENSE.
Module
Purpose
adaptive-core
Breakpoints, tokens, theme foundation, color schemes, typography, and state tokens.