Airpost
Customize

Themes

Pick a theme, follow the system's light and dark mode, adjust layout and colours, and install more themes.

A theme in Airpost is a package, like a plugin, that ships stylesheets instead of code. Each theme declares a light or dark scheme in its package.json, and Airpost uses that to decide how to render message bodies and which theme to use when it follows the system.

Choose a theme in Preferences > Appearance > Theme, or with Change Theme… in the Airpost menu (macOS) or the Edit menu (Linux). The theme picker shows a preview of each one, drawn from the theme’s own colours.

Bundled themes

ThemeSchemeDescription
LightLightThe default theme.
DarkDarkThe default dark theme.
AutomaticFollows the systemSwitches between Light and Dark with the system setting.
DarksideLight, with a dark sidebarA customizable theme with a dark sidebar.
Less Is MoreLightA minimal layout.
TaigaLightA clean theme inspired by Mailbox.

Follow the system’s light and dark mode

Set Theme to Match system

In Preferences > Appearance, choose Match system.

Pick a theme for each mode

Two more choices appear: When the system is light and When the system is dark. Any installed theme can go in either, so you could pair Taiga with Dark.

Airpost switches as soon as the system does, without a restart.

Appearance settings

Everything else in Preferences > Appearance:

SettingOptionsDefaultEffect
Use the system accent colourOn, offOnButtons and highlights use your system’s accent colour instead of the theme’s blue.
Message coloursDark when the theme is dark, Always dark, Sender’s coloursDark when the theme is darkHow message bodies are shown. Dark backgrounds can change the colours senders chose; Sender’s colours leaves them alone.
Reading paneOff, Right, BelowDepends on your setupWhere the open message shows. Click Apply; it takes you back to your mail.
Label coloursAutomatic, Bright, Pastel, Muted, EarthAutomaticThe palette labels are drawn from.
Interface size80% to 140%, in 5% steps100%Scales the whole interface.

To give one label its own colour, right-click it in the sidebar and choose Colour…. That overrides the palette for that label only.

Linux window and tray options

On Linux, Window > Title bar and menus chooses between:

OptionEffect
System title bar and menu barThe default.
System title bar, menu bar hidden until you press AltSaves vertical space.
Airpost’s own title bar with a menu buttonA compact title bar drawn by Airpost. Needs a window manager that supports it.

Changes take effect after Relaunch.

The Tray icon section (called Menu bar icon on macOS) sets how the icon shows unread mail: Blue for new and unread mail, or Red for new mail, blue for older unread mail. On Linux, Tray background chooses Automatic, Light, use dark icons or Dark, use light icons, for panels where Airpost can’t tell.

Install a theme

Themes are packages, like plugins. Choose Install Theme… (next to Change Theme…) or Developer > Install a Plugin, pick the theme’s folder, and it appears in the theme list right away. Installed themes go into the packages folder of your profile, with plugins.

Themes are stylesheets, but they still run inside the app, so only install them from sources you trust. Many Mailspring themes work, since Airpost keeps the same theme format and variables.

To remove a theme, switch to another one first, then remove its folder from packages.

Make your own

A theme is a folder with a package.json that sets "theme": "ui" and a "scheme", plus a styles folder. The simplest themes only override colour tokens. See Creating a theme and Theme tokens.

Troubleshooting

If a theme makes the app unreadable, choose another with Change Theme… from the menu, which doesn’t depend on the theme. If the app won’t start properly, launch it with --safe, which skips everything in packages, including installed themes. See Troubleshooting.