Usage

Register themes#

You must register your themes. In an android app the Application is the perfect place to do it, in jvm somewhere outside of the application scope would be fine. Just make sure that this is only done once.

// register available themes
ComposeTheme.register(*ComposeThemes.ALL.toTypedArray())

// or register some of them
// ComposeTheme.register(
//     ThemeAmberBlue.get(),
//     ThemeAquaBlue.get(),
//     ThemeBahamaAndTrinidad.get(),
//     // ...
// )

// get a single theme
// val theme = ThemeAmberBlue.get()

// or register your own themes...
// ...

Usage#

AndroidOthers

For android I do offer additional edgeToEdge features.

// simply wrap your composable content inside ComposeTheme as if you would use MaterialTheme directly
val baseTheme = remember { mutableStateOf(ComposeTheme.BaseTheme.System) }
val dynamic = remember { mutableStateOf(false) }
val theme = remember { mutableStateOf(ThemeGreenForest.KEY) } // the key of a registered theme
val state = ComposeTheme.State(baseTheme, dynamic, theme)
ComposeTheme(state = state) {

    // update edgeToEdge to the correct styles with the provided helper functions
    // e.g. like following if the layout has a primary toolbar at top and nothing at bottom
    val landscape = LocalConfiguration.current.orientation == Configuration.ORIENTATION_LANDSCAPE
    val isDark = state.base.value.isDark()
    UpdateEdgeToEdgeDefault(
        activity = this,
        themeState = state,
        statusBarColor = MaterialTheme.colorScheme.primary,
        navigationBarColor = if (landscape) {
            SystemBarStyle.defaultScrim(resources, isDark)
        } else MaterialTheme.colorScheme.background,
        isNavigationBarContrastEnforced = landscape
    )

    // content
}

// simply wrap your composable content inside ComposeTheme as if you would use MaterialTheme directly
val baseTheme = remember { mutableStateOf(ComposeTheme.BaseTheme.System) }
val dynamic = remember { mutableStateOf(false) }
val theme = remember { mutableStateOf(ThemeGreenForest.KEY) } // the key of a registered theme
val state = ComposeTheme.State(baseTheme, dynamic, theme)
ComposeTheme(state = state) {
    // content
}