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

# Settings & Themes

> Customize your dashboard with 50+ themes from the OMARCHY theme registry

# Settings & Themes

The Settings page (`/settings`) lets you customize the look of your dashboard with themes from the [OMARCHY](https://github.com/basecamp/omarchy) theme registry.

<img src="https://mintcdn.com/partio/D7OhIgZe65AaoSxp/images/app/settings-themes.gif?s=dc5f16a14d11a95da385df97cab3478f" alt="Browsing and applying dashboard themes" width="1024" height="640" data-path="images/app/settings-themes.gif" />

## Theme Library

The dashboard ships with **50+ themes** from two sources:

* **Official themes** (14) — Curated themes from the OMARCHY project, including Tokyo Night, Catppuccin, Gruvbox, Nord, Everforest, and more.
* **Community themes** (36+) — Contributed by the community, including Dracula, Synthwave '84, Aura, One Dark Pro, and others.

Each theme is displayed as a card showing:

* Preview color swatches
* Theme name and author
* A checkmark badge on the currently active theme

## Filtering

Use the controls at the top of the page to narrow down themes:

* **Search** — Filter themes by name or author
* **Type tabs** — Switch between **All**, **Dark**, and **Light** themes

## Applying a Theme

Click any theme card to apply it. The dashboard updates instantly — all colors across the interface change to match the selected theme. Your choice is saved to local storage and persists across sessions.

Click **"Reset to default"** to return to the default purple dark theme.

## Wallpaper

Some themes include background wallpaper images. When available, use the **wallpaper toggle** to enable or disable the background image for the current theme.

## How Themes Work

Themes define 12 color variables that control the entire UI:

| Variable        | Purpose                               |
| --------------- | ------------------------------------- |
| `background`    | Page background                       |
| `foreground`    | Primary text                          |
| `muted`         | Secondary/dimmed text                 |
| `accent`        | Primary accent (links, active states) |
| `accent-light`  | Lighter accent variant                |
| `accent-dark`   | Darker accent variant                 |
| `surface`       | Card/panel backgrounds                |
| `surface-light` | Elevated surface backgrounds          |
| `border`        | Border colors                         |
| `success`       | Success indicators                    |
| `warning`       | Warning indicators                    |
| `accent-orange` | Agent/AI indicators                   |

Theme colors are fetched from their source repository (GitHub raw files), parsed from various formats (TOML, Alacritty, Ghostty), and applied as CSS custom properties.