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 anTop issues
#450希望增加mcp服务3 comments · 2026-10-04#466kuikly适配2 comments · 2026-10-29#400[FR] FAB Menu0 comments · 2026-08-11#182Dependency Dashboard0 comments · 2025-12-26
Discussions
#462[Feature] 有关于谷歌的新 Styles API1 comments · 2026-10-19#429~~example app 高光跟随重力感应无效?~~2 comments · 2026-09-08#404HyperOS4 风格组件1 comments · 2026-08-14#375关于基于MiuiX二次开发ColorX的咨询1 comments · 2026-07-11#72Use on Android Projects instead of KMP1 comments · 2025-05-04
Latest release
v0.9.4 v0.9.4 2026-09-20English | 中文 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