Pelton theme template

A starting point for building a Pelton theme, a .peltontheme file that overrides Pelton's colors, fonts, and icons.

Using this template

You need git installed to clone it:

git clone https://github.com/peltonapp/pelton-theme-template.git my-theme
cd my-theme

What's inside:

my-theme/
├── LICENSE
├── README.md
└── source/
    ├── manifest.json
    └── tokens/
        └── colors.json

1. Edit source/manifest.json, at least name and base ("light" or "dark").

2. Edit source/tokens/colors.json with your own colors.

3. Add CSS or icon overrides if you want them, see the format spec linked below for how.

4. Zip source/'s contents into a .peltontheme file:

   cd source
   zip -r ../my-theme.peltontheme manifest.json tokens css assets

5. Import it into Pelton (Settings > Themes > Import theme...) to test it.

Full documentation

• Themes, what a theme can and can't do
• Theme format, the full manifest schema, token list, and size limits
• Create a theme, the complete walkthrough this template is based on, including how to submit a finished theme to the community gallery at pelton-themes

License

This template itself is public domain (CC0), see LICENSE. A theme you build from it is yours, license it however you like.