Pelton Themes

The community gallery of themes for Pelton, the privacy-first email client.
Browse, download, and share .peltontheme files — no account, no tracking.

🖼️ Browse the gallery → themes.pelton.app

 

---

What is this?

A theme overrides Pelton's design tokens — every colour, font, radius and shadow — plus optional CSS and interface icons. Anything a theme does not override falls back to the built-in light or dark look, so a theme is always complete.¹

Themes ship as single .peltontheme files (a zip container). This repository collects them so you can find one, download it, and share your own.

Links

🌐 Website	https://pelton.app
🖼️ Theme gallery	https://themes.pelton.app
📖 Documentation	https://docs.pelton.app
🎨 Theme docs	https://docs.pelton.app/themes/ · format spec · create a theme
💻 Main app repo	https://github.com/TRC-Loop/Pelton
🖥️ Website repo	https://github.com/TRC-Loop/pelton.app
🎭 This repo	https://github.com/TRC-Loop/pelton-themes
💬 Community	https://arne.sh/discord

Install a theme

1. Open a theme's folder under themes/ and download its .peltontheme file.
2. In Pelton, go to Settings → Themes → Import theme and pick the file.
3. Review the metadata and raw CSS in the import preview, then click the theme's card to apply it.

Tip

Sharing a theme with a friend is just sending them the .peltontheme file.

Gallery

Browse every theme with live previews and one-click download at themes.pelton.app, or see the full list in GALLERY.md — both are generated automatically from the themes in this repo.

Note

Each theme's own README.md also carries a metadata table (version, compatibility, author and license) generated from its manifest.

Contribute a theme

We accept themes two ways — pick whichever suits you:

flowchart LR
    A([You made a theme]) --> B{Comfortable<br/>with git?}
    B -- Yes --> C[Open a Pull Request]
    B -- No --> D[Open a 'Submit a theme' issue]
    C --> E{{CI validates the theme}}
    D --> F[Maintainer opens the PR for you]
    F --> E
    E --> G([Merged into the gallery])

Loading

Quick start (pull request)

# 1. Fork, then copy the template
cp -r themes/_TEMPLATE themes/my-theme

# 2. Edit the source, then zip it into a .peltontheme
cd themes/my-theme/source
zip -r ../my-theme.peltontheme manifest.json tokens css assets

# 3. Add a LICENSE and README, then validate before pushing
cd ../../..
python3 scripts/validate_theme.py themes/my-theme

Then open a pull request. Full details are in CONTRIBUTING.md.

Requirements at a glance

• A .peltontheme file in themes/<your-theme>/
• A LICENSE in the folder
• Passes scripts/validate_theme.py (run by CI)
• version and pelton.min set in the manifest
• A preview screenshot (recommended, not required)
• A README.md describing the theme (recommended)

Important

Themes must bundle their fonts and images. A remote url() or @import can be used to track people, so CI rejects them — see the security model.

Licensing

Each theme is licensed by its own author under the LICENSE file in its folder — check there before reusing one. The repository tooling and documentation are maintained by the Pelton community.

---

_{Not affiliated with any brand whose palette a theme may reference. Built by the Pelton community.}

Footnotes

1. Full details, the complete token surface, and the security model are in the theme documentation. ↩