A UI library for Compose Multiplatform

★ 1,656⑂ 137👁 6⑃ 419● 58▤ 43
KotlinApache-2.0Created 2024-08-06compose-miuix-ui.github.io/miuix/
下载:v0.9.4v0.9.4 ↓0.9.42026-09-20
1,656
stars
137
forks
6
watchers
419
prs
58
issues
43
releases

README

Miuix

A UI library for Compose Multiplatform.

 This library is experimental. APIs may change without notice.






 Supported Platforms

!Android
!iOS
!macOS
!Desktop
!Web

 Demos




 Modules

| Module              | Description                                                |
| ------------------- | ---------------------------------------------------------- |
| miuix-ui          | Core UI component library                                  |
| miuix-preference  | Preference components library, depends on miuix-ui       |
| miuix-icons       | Extended icon library, can be used independently           |
| miuix-glass-icons | Glass icon library, can be used independently              |
| miuix-material    | Render primitives and material definitions                 |
| miuix-blur        | Blur effect library, can be used independently             |
| miuix-squircle    | Squircle shapes library, can be used independently         |
| miuix-glass       | Glass surfaces and components library                      |
| miuix-nav         | Navigation library, can be used independently              |
| miuix-window      | Desktop window & caption bar styling library (Desktop JVM) |

 Getting Started

diff
kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("top.yukonga.miuix.kmp:miuix-ui:")
            // Optional: Add miuix-preference for preference components
            implementation("top.yukonga.miuix.kmp:miuix-preference:")
            // Optional: Add miuix-icons for more icons
            implementation("top.yukonga.miuix.kmp:miuix-icons:")
            // Optional: Add miuix-glass-icons for the Glass icon set
            implementation("top.yukonga.miuix.kmp:miuix-glass-icons:")
            // Optional: Add miuix-blur for blur effects
            implementation("top.yukonga.miuix.kmp:miuix-blur:")
            // Optional: Add miuix-squircle for squircle (smooth rounded corner) shapes
            implementation("top.yukonga.miuix.kmp:miuix-squircle:")
            // Optional: Add miuix-glass for the glass surfaces and components
            implementation("top.yukonga.miuix.kmp:miuix-glass:")
            // Optional: Add miuix-nav for navigation
            implementation("top.yukonga.miuix.kmp:miuix-nav:")
            // Other dependencies...
        }
        // Optional: Add miuix-window for desktop window and caption bar styling (Desktop JVM)
        desktopMain.dependencies {
            implementation("top.yukonga.miuix.kmp:miuix-window:")
        }
        // Other sourceSets...
    }
    // Other configurations...
}


 Usage

- Provide a color scheme via MiuixTheme(colors = ...), e.g., lightColorScheme() or darkColorScheme().

kotlin
@Composable
fun AppTheme(
    content: @Composable () - Unit
) {
    val colors = if (isSystemInDarkTheme()) darkColorScheme() else lightColorScheme()
    return MiuixTheme(
        colors = colors,
        content = content
    )
}


- Use ThemeController to manage modes an

Top issues

Discussions

Latest release

v0.9.4 v0.9.4 2026-09-20
English | 中文



 Highlights

- New: miuix-nav module — a self-contained Compose Multiplatform navigation runtime with continuous stack depth (animatedTop), slide/modal transitions, predictive back, opt-in swipe-to-dismiss, and entry lifecycle / state management. Replaces miuix-navigation3-ui with zero dependency on androidx.navigation3.
- New: BreadcrumbBar component — horizontally scrollable capsule-shaped path segments, configurable highlighting and colors, plus BreadcrumbItem and joinToPath() helpers.
- miuix-blur gains progressive blur — Modifier.progressiveTextureBlur(), BackdropE

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON