Reusable Compose Multiplatform components for Android, desktop (JVM), and iOS. The library adapts the platform-neutral tokens from kommon's design-system module; it does not define a competing design system.

// build.gradle.kts
kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("io.github.maniramezan.kmpcomponents:components:<version>")
        }
    }
}

kommon's design-system, Compose runtime, and material3 are exposed as api dependencies, so token types and Material components are available without extra declarations.

Targets: android (minSdk 26), jvm, iosArm64, iosSimulatorArm64.

var themeMode by remember { mutableStateOf(ThemeMode.SYSTEM) }
var provider by remember { mutableStateOf(ProviderConfigurationState()) }
var submitted by remember { mutableStateOf(false) }

KmpTheme(mode = themeMode) {
    SectionCard(title = "Appearance") {
        ThemeModeSelector(selected = themeMode, onSelect = { themeMode = it })
    }
    SectionCard(title = "Provider", description = "Where requests are sent") {
        ProviderConfigurationForm(
            state = provider,
            onStateChange = { provider = it },
            showValidationErrors = submitted,
            onDone = { submitted = true },
        )
        if (submitted && provider.isValid()) {
            StatusMessage("Saved", tone = StatusTone.SUCCESS)
        }
    }
}

All components are stateless unless noted, take a Modifier as their first optional parameter, and accept user-visible strings as parameters (or a *Labels data class) so apps can localize them.

Run the interactive catalog on desktop:

./gradlew :sample:run

KmpTheme(mode, tokens) converts kommon tokens once per token change (results are remembered) and provides:

To brand an app, pass a copy of KommonDesignTokens.default with your own values:

val brand = KommonDesignTokens.default.copy(
    lightColors = KommonDesignTokens.default.lightColors.copy(primary = ColorToken(0xFF_00_6C_4F)),
)
KmpTheme(tokens = brand) { /* ... */ }

• ProviderConfigurationState.toString() redacts apiKey, so the state can be logged safely. Persisting the key securely (Keychain / Keystore) is the app's job.
• SecretTextField does not restore its revealed state after recreation and hides the value again when it is cleared.

./gradlew :components:allTests            # unit tests on every target (UI tests run on jvm)
./gradlew :components:jvmTest             # fastest loop: common + desktop UI tests
./gradlew :components:assemble :sample:compileKotlinJvm

iOS tests need macOS with Xcode. The build needs access to Google Maven for the Android plugin.

To build against a local checkout of kommon next to this repo, pass -PuseLocalKommon=true; Gradle substitutes io.github.maniramezan.kommon:design-system with the included build.

Releases are automated by Release Please from Conventional Commit messages (feat:, fix:, feat!:). Contributor and AI-agent conventions live in AGENTS.md.