Menu
Muqun · Themes

Themes

Every theme in the community repository, drawn here from its own .muqun-theme file — both variants, on a phone and a tablet, with the terminal palette and the artwork. Download one and import it in the app.

preview

Preview your own

Drop a .muqun-theme file here to see it exactly as the gallery would draw it. Nothing leaves your browser.
Editing a theme right now, or hosting one somewhere? The preview page draws it from a URL and reloads as it changes.
Preview from a URL

muqun-theme init

Make your own

A theme is a small ZIP: one JSON file of colours and an assets folder of images. The toolchain scaffolds one, checks its contrast, and packs it; the repository takes them as pull requests.
  1. 01

    Scaffold it

    One command writes a complete, installable theme with placeholder art. Or install the skill and describe the look you want to your agent.

    sh
    bunx @osuki-dev/muqun-theme init my-theme
    sh
    bunx skills add osuki-dev/muqun-theme-cli
  2. 02

    Check it

    validate runs the app’s own checks; contrast shows what the palette costs in translucency. Both work on the folder, no packing needed.

    sh
    bunx @osuki-dev/muqun-theme validate my-theme
    sh
    bunx @osuki-dev/muqun-theme contrast my-theme
  3. 03

    Send it

    Open a pull request with the src/<id> folder only. CI packs it, and it appears here within minutes of the merge.