> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Themes and scenes

> How to choose, create and share themes in Flexxible KB, apply your organization's branding and change the Home scene.

A theme defines how Flexxible KB looks: its colors, fonts, sizes and logo. A scene is what **Home** draws behind the greeting. Each person chooses their own, and the organization can set defaults to apply its branding.

Themes and scenes are in **Settings** → **Themes**, in the **Themes** and **Scenes** tabs.

## Choose a theme

![Theme gallery: the built-in themes, those shared in the organization and your own, each with a preview.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-themes.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=277026eb2245f918a97f0aad02b8efc1)

The gallery groups themes into:

* **Built-in.** The themes that come with Flexxible KB. They can't be changed or deleted, but you can duplicate them.
* **Shared in** your organization. Themes someone has shared with everyone.
* **Only you.** Your themes. Nobody else sees them until you share them.

Select a theme to use it. **Light or dark** decides which side of the theme you see on that device: **Light**, **Dark** or **System**, which follows your computer.

From the [command palette](https://docs.flexxible.com/en/features/flexxible-kb/search.md), **Change theme…** previews each theme as you move through the list.

If you don't choose one, you see your organization's default theme.

## Create a theme

Select **New theme**, or **Duplicate and edit** in an existing theme's menu. The editor has two tabs, which work on the same theme:

### With Teammate

Describe how you want the theme to look, or start from something you already have:

* **Like a website.** Type your company's website address and Teammate takes its colors, fonts and logo from it.
* **From a brand document.** Attach a PDF or Word file with your style guide.
* **Like an image.** Paste or attach an image.
* **Or just say it.** For example, "dark and calm, with our orange".

Each Teammate answer is a single step, which you can **Undo**.

### By hand

| Section | What you define |
| - | - |
| **Colors** | Background, sidebar, text, accent and brand, for the light side and the dark side. |
| **Palette** | The colors for statuses, notices, people, agents and code. |
| **Fonts** | The interface font, the reading font and the code font. |
| **Sizes** | Interface and reading size, line spacing, corners and density. |
| **Finish** | How menus, dialogs, cards and the main button catch the light. |
| **Logo** | The logo on light, on dark and the browser tab icon. |
| **Advanced** | Each color in the app, individually. |

The whole app shows your changes as you make them. Nothing is saved until you select **Save theme**.

The editor checks that text is readable. It shows which colors don't meet WCAG AA contrast and suggests the closest value that does.

## Share a theme and apply the organization's branding

In the menu of one of your themes:

* **Share with** your organization makes it available to everyone.
* **Make default** makes it the theme seen by everyone who hasn't chosen another. With your company's logo and colors, this is how you apply your branding to Flexxible KB.
* **Export as file** downloads it. **Import…**, in the gallery, loads it into another organization.
* **Keep it just for me** stops sharing it, and **Delete theme** deletes it. Anyone who was using it goes back to the default.

> [!NOTE]
>
> A theme can only be shared if its text is readable with a minimum contrast. Until it meets that, only you can use it.

> [!TIP]
>
> If a theme makes Flexxible KB hard to read, add `?theme=flexxible` to the address of any page to go back to the Flexxible theme.

## Scenes

The scene is what **Home** draws behind the greeting, in the colors of your current theme. It's chosen separately from the theme, in the **Scenes** tab.

![Scenes tab: the built-in scenes with a preview of Home with each one.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-scenes.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=30c55f673e3a4833cb227ea1822db064)

Flexxible KB includes several scenes, from the most understated, such as **Blocks**, to an animated one, **Boot**.

To create your own scene, select **New scene** and describe in a few words what you want to see, for example "a night sky with slow shooting stars". Teammate writes it and shows it in a preview of **Home**. If you want to adjust it, tell it what to change.

> [!NOTE]
>
> Writing a scene takes a minute or two. Keep the page open in the meantime. Nothing is saved until you select **Save scene**.

Like themes, a custom scene can be shared with the organization and made the default.

## Next steps

* [Settings](https://docs.flexxible.com/en/features/flexxible-kb/settings.md)
* [Teammate](https://docs.flexxible.com/en/features/flexxible-kb/teammate.md)
