Skip to content

Getting Started Installation

Installation

FormaUI 0.1.0-beta04 is live on Maven Central. Add one dependency to your Compose Multiplatform module, wrap your app in the theme, and start dropping in components.

On Maven CentralKotlin 2.0+Compose Multiplatform 1.7+Android · iOS · Desktop · Wasm

Add the dependency

Add FormaUI to your shared/common module’s Gradle dependencies.

build.gradle.kts
dependencies {
    implementation("io.github.devsnackio:components:0.1.0-beta04")
}

Or use a version catalog

If your project centralizes dependencies in gradle/libs.versions.toml, declare FormaUI there instead.

gradle/libs.versions.toml
[versions]
formaui = "0.1.0-beta04"

[libraries]
formaui-components = { module = "io.github.devsnackio:components", version.ref = "formaui" }

Wrap your app in FormaTheme

Every FormaUI component reads its colors, type, spacing, and shape from FormaTheme. Install it once, at the root of your composition.

App.kt
@Composable
fun App() {
    FormaTheme(darkTheme = isSystemInDarkTheme()) {
        Surface {
            HomeScreen()
        }
    }
}

Use your first component

Everything inside FormaTheme already matches the brand theme — no per-component styling required.

HomeScreen.kt
FormaButton(onClick = { navigate() }) {
    Text("Get started")
}

Dynamic color

Material You dynamic color is Android-only. On every other target FormaUI falls back to the static brand palette shown across this site — no configuration needed.

PreviousOverviewNext Button