Your own theme

This page is for the person who writes the notes and wants colours of their own.

Import a theme

Open Settings and go to Appearance. Select Import a theme and choose a theme file. When the file is correct, the application says that the theme is imported, and the theme shows in the Theme list with the themes that ship with the application. Choose it there, as you choose any other theme.

Your account keeps the theme, so it follows you to every browser where you sign in. An account keeps a limited number of imported themes. To remove one, select Delete next to its name under Imported themes. When you delete the theme in use, the application goes back to the default theme.

Start from a theme you like

Choose a theme, then select Download this theme. The file that you get is a correct theme file with every colour in it. Change its name and its colours, then import it.

The theme file

A theme file is a JSON file. It holds a name, and a light palette, a dark palette or both. When a theme has one palette, the application uses it for light and for dark.

Each palette holds two groups: tokens, the colours of the application, and syntax, the colours of code inside a code block. Write each colour as # and six hexadecimal digits, for example #1f2328.

The application names a colour in words, such as Muted text. In the file, the same colour is one word, textMuted. The downloaded file holds every name.

When a theme does not import

The application reads the whole file before it keeps anything. When a part of the file cannot be used, the theme does not import, and the settings list every part to correct. Each line names the palette, the colour and what to change.

• A colour that is missing, or that is not # and six hexadecimal digits.
• Text that is hard to read on a background, or an edge or a focus ring that is hard to see.
• A shade behind a dialog that is lighter than a background, or a quiet edge that is as strong as the control edge.

Correct the file and import it again.