miuixlisted
Install: claude install-skill yspbwx2010/skills
# Miuix
Miuix is a Compose Multiplatform UI library (Android / desktop / web / iOS) that recreates Xiaomi's
HyperOS visual language. It is **not** a Material3 reskin — press feedback, corners, overscroll and
the overlay mechanism are all a different system. This skill targets **miuix 0.9.4**.
## Read your situation first
| Situation | What to do |
| --- | --- |
| Empty directory / new app | Use `scripts/new_app.py` to generate a project that compiles, then only edit the UI code (see "From scratch") |
| Existing Android or KMP project | Add the dependencies per "Integrate into an existing project", and **check compileSdk 37 first** |
| The project depends on a miuix that isn't 0.9.4 | Tell the user this skill is written for 0.9.4 and signatures may differ; treat the source for that version as authoritative: `https://github.com/compose-miuix-ui/miuix/tree/v<version>` |
| You can read the miuix source (submodule or local checkout) | Take signatures from the source; use `references/` for traps, specs and choices |
## From scratch
`<skill>` is this skill's directory (next to `SKILL.md`). Run in the target directory:
```bash
python3 <skill>/scripts/new_app.py . --name "My App" --package com.example.myapp # Android + desktop + web
python3 <skill>/scripts/new_app.py . --name "My App" --package com.example.myapp --targets android,desktop
python3 <skill>/scripts/new_app.py . --name "My App" --package com.example.myapp --layout android # plain Android, no KMP