Theme documentation.

How Omarchy themes work, from your first colors.toml to a listing that stays current.

10 guides · checked on Omarchy 4.0.0.alpha, September 15, 2026

CHOOSE YOUR NEXT ADVENTURE

Where do you want to go?

Meet the files that make a theme.

Build your first palette, one step at a time.

Package it, test it, share it.

What an Omarchy theme actually is, and what happens when someone applies yours.

Every file a theme repository can contain, what each one does, and which ones are dropped on install.

Every palette key, how missing values are derived, and how templates read them.

From a copied directory to a working theme, with a complete minimal example.

Contrast, the neutral ramp, choosing an accent, and the differences that matter in light mode.

Formats, sizes, ordering, and the licensing question you have to answer before you publish.

Naming rules, the install command, getting onto omarchy.org, and how this gallery imports themes.

Submit your theme to this gallery, keep the listing current as you push, and what review means for your images.

Where a theme stops and a plugin begins, and what to link when yours needs one.

What these docs are based on, what we deliberately did not copy, and where to read upstream.

Put your new ideas to work. The Studio keeps a live desktop beside your colors.