# Themes

> Pick a built-in theme for light and dark, bring yours from your editor or terminal, or make your own.

Source: https://sesh.codes/docs/themes/

Sesh uses VS Code color themes. The theme colors code, diffs and terminals, and, if you like, the chat, the sidebar and the controls. You pick one theme for light mode and one for dark.

## Pick a theme

1. Open **Settings › Theme**.
2. Choose **Appearance**: **System**, **Light** or **Dark**.
3. Choose a **Light theme** and a **Dark theme**. The one in use follows the appearance.

The **Preview** shows the result as you go.

## Import a theme from your editor or terminal

1. In **Settings › Theme**, under **Import**, click **Choose File…** next to **Theme File**.
2. Pick the file: a VS Code theme (`.json`), a terminal theme (Ghostty, iTerm2, Terminal, kitty, Alacritty, WezTerm or Warp), or an Xcode, Zed or Sublime Text theme.
3. For a terminal theme, check the colors, choose **Use for** Light, Dark or Neither, and click **Import**.

A VS Code theme becomes your light or dark theme, whichever it was made for. Terminal themes have no code colors, so Sesh picks them from the 16 terminal colors; click **Customize…** to change any before importing.

On a Mac, **Import** also lists the themes your terminals and editors are using: click **Import** next to one, or **Choose…** when an app has several. On iPhone and iPad, pick the file from Files.

## Make your own theme

1. In **Settings › Theme**, click **New Theme** and choose which of your themes to copy, or click **Edit…** next to one of **My Themes**.
2. Change any color: backgrounds, text, accent, each kind of code, the terminal's 16 colors, diffs. Every window shows the change as you make it.
3. Click **Save**. A new theme becomes your light or dark theme.

**Export…** saves it as a VS Code theme, so it works in VS Code too.

## How far the theme goes

Code, terminals and diffs always use the theme. **Use the theme's colors** (on by default) takes it further: the chat, Changes and the sidebar get the theme's backgrounds, and buttons, selection and links get its accent. Turn it off for the system's colors there. Windows keep the standard look either way.

On a Mac, Sesh's Dock icon takes the theme's colors while it runs. On iPhone and iPad, **App Icon** offers the default icon or one in a built-in theme's colors; it doesn't change with the theme.

## On your other devices

Your appearance, your light and dark themes and **Use the theme's colors** follow you over iCloud, including imported themes you've chosen.

## Good to know

- An imported theme over 256 KB, or one you haven't chosen for light or dark, stays on the device you imported it on.
- In the Mac App Store version, the apps under **Import** need you to allow reading your home folder, where these apps keep their settings. Click **Allow Access…**, then **Allow**. It asks once.
