Getting started
Every port lives in its own repository under the Moonlight-theme organization. There's no single installer — each app has its own theming system, so each port ships exactly what that app needs: a CSS file, a settings import, a plugin, and so on.
The short version:
1. Open the port's repo on GitHub (see the Ports page)
2. Follow that repo's README — it has the exact install steps for that app
3. Restart or reload the app
4. You're camping under Moonlight 🏕
Stuck on a specific port? Open an issue on that port's repo, or drop a message in the
Discord.
Color reference
The complete fifteen-color Moonlight palette. Click any hex value to copy it.
| # | Name | Root | Hex | RGB | Family |
|---|
| 01 | light-I | moonlight-l-i | #c0cedd | 192, 206, 221 | White moon |
| 02 | light-II | moonlight-l-ii | #99a0a8 | 153, 160, 168 | White moon |
| 03 | light-III | moonlight-l-iii | #c6c3c0 | 198, 195, 192 | White moon |
| 04 | dark-I | moonlight-d-i | #191f28 | 25, 31, 40 | Night sky |
| 05 | dark-II | moonlight-d-ii | #1f2730 | 31, 39, 48 | Night sky |
| 06 | dark-III | moonlight-d-iii | #374656 | 55, 70, 86 | Night sky |
| 07 | accent-I | moonlight-a-i | #ecbd7c | 236, 189, 124 | Light |
| 08 | accent-II | moonlight-a-ii | #c69f68 | 198, 159, 104 | Light |
| 09 | accent-III | moonlight-a-iii | #93764d | 147, 118, 77 | Light |
| 10 | color-I | moonlight-c-i | #c68768 | 198, 135, 104 | Frills |
| 11 | color-II | moonlight-c-ii | #c66868 | 198, 104, 104 | Frills |
| 12 | color-III | moonlight-c-iii | #c66890 | 198, 104, 144 | Frills |
| 13 | color-IV | moonlight-c-iv | #6880c6 | 104, 128, 198 | Frills |
| 14 | color-V | moonlight-c-v | #68aec6 | 104, 174, 198 | Frills |
| 15 | color-VI | moonlight-c-vi | #9fc76d | 159, 199, 109 | Frills |
Color families
White moon (01–03) is the light family, used mainly as text color. light-I is the brightest and most common; light-II leans a little bluer, light-III a little warmer — both exist to add variation without breaking contrast.
Night sky (04–06) is the primary dark family and the backbone of every port. dark-I is the deepest, most eye-comfortable background; dark-II sits a step brighter for surfaces and cards; dark-III is saturated enough to use for borders, lines, and hover states.
Light (07–09) is the accent family — a warm, campfire yellow. accent-I is the headline color, the one you reach for first; accent-II reads beautifully against the Night sky family as a secondary accent; accent-III is the deepest variation, good for subtle highlights.
Frills (10–15) are six wide-ranging hues — from orange through pink, purple, turquoise, and green — kept just muted enough to still feel like Moonlight. Use them for tags, syntax highlighting, charts, or status colors.
Usage guidelines
A few habits that keep ports feeling consistent with each other:
- Use
dark-I for the main background and dark-II for anything that needs to sit visually "above" it — panels, cards, modals.
- Reserve
accent-I for the one thing on screen you want a person to notice first — a primary button, an active tab, a focus ring.
- Lean on
light-I for body text and light-II for secondary or muted text, rather than introducing a new gray.
- Pull from the Frills family for anything categorical (tags, labels, syntax tokens) instead of inventing new hues.
Build a port
Want Moonlight in an app that isn't listed yet? Start from the new-port-template repository — it already has the standard README structure, license, and folder layout every other port uses.
# 1. Use the template on GitHub ("Use this template" button)
# 2. Rename the repo to your app's name
# 3. Map the 15 colors above onto your app's theming format
# 4. Add a screenshot and fill in the README
# 5. Open a request to join the Moonlight-theme organization
Once it's in good shape, reach out on Discord or open an issue on the Moonlight repo and it'll get added to the Ports page.
FAQ
Is Moonlight free to use?
Yes — every port is open source, most under GPL-3.0. Check the individual repo for its exact license.
Can I use the colors outside of the listed ports?
Absolutely. The hex values on this page are the whole palette — use them anywhere: dotfiles, a personal site, a design file.
Where do I report a bug in a specific port?
On that port's own repository — each one has its own issue tracker.