Community themes. Sent in, checked, ready to use.
Themes people made and sent to the repository in a pull request. Each card draws a sketch of the app from the theme file itself. Open one in the theme builder to change it, or download the .kdl and put it in your themes folder. The 11 themes that come with the app are in the built-in gallery.
No community themes yet. Be the first.
This gallery is built from themes/community/ in the repository, and that folder is still empty. Make a theme, send it in a pull request, and it shows up here with a live preview, a button that opens it in the theme builder and the file to download.
Send yours. One file, one pull request.
- Make the theme in the theme builder, or by hand with Writing themes. In the builder's File tab, fill in the name, the author, a description and the license: the checklist there (also linked from Export) lists anything still missing.
- Download the
.kdl. Its name comes from the theme's name: "Neon Dusk" becomesneon-dusk.kdl. - Fork the repository, add the file to
themes/community/and open a pull request. One theme per pull request. - Optional, before sending:
python3 tools/gen_site.py --check-communityruns the same checks as CI, andlarpercord --theme neon-dusk(with the file in your themes folder) shows it in the app.
- It has to load in the app. The site build reads every file in the folder with the app's rules (syntax, color tokens, color expressions, component names) and stops with
file:line:columnat the first problem. The tests then load each theme with the site's copy of the app's theme loader, in both modes and with every option. CI runs both on every pull request. To be sure, try it in the app itself (step 4). - A name of its own. Not the name of a built-in theme (a file called
orbital.kdlwould take its place in the app) and not one already in the gallery. A built-in theme with only the name changed is turned away too. - No copyrighted logos or fonts. The folder only takes
.kdlfiles, so no images or font files. Don't redraw someone else's logo withlabel,shapeor ASCII art, and only name fonts that people can get freely: the app looks the family up on their system. - An open license.
license=on thethemenode, one from the gallery's list written as its SPDX identifier (CC0-1.0,CC-BY-4.0,MIT,GPL-3.0-or-later…), so people know they may use and change it. If the colors came from someone else's theme, its license has to allow that, and the description should credit the author.