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

# Theming

> One accent colour to theme the whole UI - locally or across every Awoken resource.

The Awoken UI is driven by a single **accent colour** plus a small set of theme presets. Set the accent once and every active element - selected option, buttons, highlights, the save/purchase button - re-themes to match.

## Accent colour

The accent is resolved in this order:

1. The `awoken:primaryColor` **convar**, if set.
2. Otherwise `Config.PrimaryColor` in `shared/theme.lua`.

```lua shared/theme.lua theme={"dark"}
-- Fallback used when the convar is not set
Config.PrimaryColor = "#00E5FF"
```

### Global Awoken accent (cross-resource theming)

If you run multiple Awoken-branded resources (appearance, inventory, recorder, …) and want them all to share one accent, set a single convar in `server.cfg`:

```cfg server.cfg theme={"dark"}
setr awoken:primaryColor "#00E5FF"
```

When set, this convar **overrides** `Config.PrimaryColor` for every Awoken resource at once - set it once and your appearance menu, inventory and recorder all share the same brand colour. Leave it unset to use each resource's own value. The value is read when the UI loads.

## Theme presets

`shared/theme.lua` ships three theme presets. `currentTheme` selects the active one.

```lua shared/theme.lua theme={"dark"}
Config.Theme = {
    currentTheme = "awoken",  -- "awoken" | "default" | "qb-core"
    themes = { ... }
}
```

| Preset               | Look                                                                              |
| -------------------- | --------------------------------------------------------------------------------- |
| `awoken` *(default)* | The modern dark Awoken styling - rounded corners, Inter font, smooth transitions. |
| `default`            | Flatter, squarer styling for a more neutral look.                                 |
| `qb-core`            | A QBCore-flavoured red/dark theme.                                                |

The accent colour is injected into whichever preset is active, so switching presets keeps your `awoken:primaryColor`.

<Tip>
  After editing `shared/theme.lua`, run `ensure illenium-appearance` and reconnect - the UI reads the theme fresh on load.
</Tip>