{"full_name":"compose-miuix-ui/miuix","owner":"compose-miuix-ui","name":"miuix","shard":"1","url":"https://github.com/compose-miuix-ui/miuix","description":"A UI library for Compose Multiplatform","homepage":"http://compose-miuix-ui.github.io/miuix/","topics":["miuix","compose-multiplatform","compose-multiplatform-library","compose-ui"],"tag_pages":["compose-multiplatform"],"language":"Kotlin","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/178124506?v=4","created_at":"2024-08-06T09:36:19Z","pushed_at":"2026-11-16T07:44:10Z","metrics":{"stars":1656,"forks":137,"watchers":6,"issues":58,"prs":419,"releases":43,"issues_open":4,"issues_closed":54,"prs_open":3,"prs_closed":32,"prs_merged":384,"discussions":5},"growth":{},"history":{"dates":["2026-11-16"],"stars":[1656],"forks":[137],"watchers":[6],"issues_open":[4],"prs_open":[3]},"boards":{},"same_owner":[],"issues":[{"number":450,"title":"希望增加mcp服务","comments":3,"created_at":"2026-10-04T11:19:53Z"},{"number":466,"title":"kuikly适配","comments":2,"created_at":"2026-10-29T09:13:35Z"},{"number":400,"title":"[FR] FAB Menu","comments":0,"created_at":"2026-08-11T01:35:52Z"},{"number":182,"title":"Dependency Dashboard","comments":0,"created_at":"2025-12-26T06:49:08Z"}],"discussions":[{"number":462,"title":"[Feature] 有关于谷歌的新 Styles API","comments":1,"category":"Ideas","created_at":"2026-10-19T08:07:41Z"},{"number":429,"title":"~~example app 高光跟随重力感应无效？~~","comments":2,"category":"General","created_at":"2026-09-08T16:55:33Z"},{"number":404,"title":"HyperOS4 风格组件","comments":1,"category":"Ideas","created_at":"2026-08-14T08:55:13Z"},{"number":375,"title":"关于基于MiuiX二次开发ColorX的咨询","comments":1,"category":"Q&A","created_at":"2026-07-11T09:44:57Z"},{"number":72,"title":"Use on Android Projects instead of KMP","comments":1,"category":"Q&A","created_at":"2025-05-04T15:31:44Z"}],"latest_release":{"name":"v0.9.4","tag":"v0.9.4","published_at":"2026-09-20T08:33:49Z","body":"[English](#english) | [中文](#chinese)\r\n\r\n<a id=\"english\"></a>\r\n\r\n## Highlights\r\n\r\n- **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`.\r\n- **New: `BreadcrumbBar` component** — horizontally scrollable capsule-shaped path segments, configurable highlighting and colors, plus `BreadcrumbItem` and `joinToPath()` helpers.\r\n- **`miuix-blur` gains progressive blur** — `Modifier.progressiveTextureBlur()`, `BackdropEffectScope.progressiveBlur()`, and `ProgressiveBlur` presets (`Top` / `Bottom` / `Left` / `Right`) provide directional blur with a sharp clear end. The gradient band and falloff curve are configurable.\r\n- **Pager gesture conflict resolution** — new `Modifier.pagerGestureOverride()` utilities let horizontal swipes switch pages while a vertical list is flinging or overscrolling. Choose native, cross-axis interception, or tap-to-halt behavior; `PagerState.springAnimateToPage()` adds spring-based page navigation.\r\n- **Navigation state and integration** — `LocalNavTransitionScope` exposes the current entry's live transition state, including `isRunning`; navigation entries now inherit the SavedState creation extras and ViewModel factory needed by `SavedStateHandle` and integrations such as Hilt. Back events are bridged across separate Android windows.\r\n- **Navigation component customization** — `NavigationBarItem` and `FloatingNavigationBarItem` gain `colors`; `NavigationRail` restores the compact selection highlight and separates fixed-layout and expandable overloads.\r\n- **More configurable dialogs** — `OverlayDialog` / `WindowDialog` gain `maxWidth`, `largeScreen`, and `cornerRadius`. Centered dialogs use a fixed 32dp default corner radius.\r\n- **Scrolling and refresh improvements** — `PullToRefresh` separates its trigger threshold from indicator scaling; `TabRow` and `TabRowWithContour` contain horizontal overscroll instead of passing it to a parent pager; overscroll and refresh handling now distinguish actual gesture sessions from wheel input.\r\n- **Platform and tooling updates** — Compose Multiplatform **1.12.0**, Kotlin **2.4.20**, Lifecycle **2.11.0**, AGP **9.4.1**, and Gradle **9.7.1**. The shared Android minimum SDK rises from 23 to **24**; `miuix-blur` continues to require API **33**.\r\n\r\n## ⚠️ Breaking Changes\r\n\r\n### 1. `miuix-navigation3-ui` removed, replaced by `miuix-nav`\r\n\r\nReplace the dependency and migrate the Navigation3 imports and back-stack code to the new runtime. This is not a drop-in artifact rename: `NavKey`, `rememberNavBackStack`, `NavDisplay`, and `NavController` now belong to Miuix.\r\n\r\n```kotlin\r\n// Old dependency\r\nimplementation(\"top.yukonga.miuix.kmp:miuix-navigation3-ui:0.9.3\")\r\n\r\n// New dependency\r\nimplementation(\"top.yukonga.miuix.kmp:miuix-nav:0.9.4\")\r\n```\r\n\r\n```kotlin\r\nimport androidx.compose.runtime.Composable\r\nimport kotlinx.serialization.Serializable\r\nimport top.yukonga.miuix.kmp.nav.core.NavDisplay\r\nimport top.yukonga.miuix.kmp.nav.core.NavKey\r\nimport top.yukonga.miuix.kmp.nav.core.rememberNavBackStack\r\n\r\n@Serializable\r\nsealed interface Route : NavKey {\r\n    @Serializable data object Home : Route\r\n}\r\n\r\n@Composable\r\nfun App() {\r\n    val backStack = rememberNavBackStack<Route>(Route.Home)\r\n    NavDisplay(\r\n        backStack = backStack,\r\n        onBack = { backStack.removeLastOrNull() },\r\n    ) {\r\n        entry<Route.Home> { HomeScreen() }\r\n    }\r\n}\r\n```\r\n\r\nUse the route **supertype** as the explicit type argument so the whole serializable route hierarchy can be saved and restored. Swipe-to-dismiss is opt-in via `entry(swipeDismiss = …)`; built-in transition presets do not enable it automatically. Access `LocalNavTransitionScope.current` only inside a `NavDisplay` entry.\r\n\r\nSee the [miuix-nav guide](https://compose-miuix-ui.githu","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}