Name, logo and colours
What it does
Sets the name in the browser tab and header, the logo, the View website button and Keel's colours.
Options
| Key | Default | What it does |
|---|---|---|
title | Dashboard | Tab and header title |
subtitle | Content dashboard | Smaller text under the title |
logo | none (the Keel mark) | Image URL shown in the header, e.g. /static/logo.svg |
website_url | / | Where the header's View website button goes |
theme.<css-var> | none (Keel's colours) | A colour or value per theme variable (list below) |
Example
keel:
title: 'Marlin'
subtitle: 'Real estate'
logo: '/static/marlin-logo.svg' # example value
theme:
accent: '#006B7A'
accent-hover: '#0A4650'
brand: '#0C1B1C'
soft: '#F5F2EC'
r: 10px
Most projects only need accent and brand. Write the variable name without the leading --. A value may contain letters, digits, spaces and # ( ) , . % - (so colours, rgba(…), linear-gradient(…) and sizes work; quotes do not).
Theme variables
Main colours – these are usually all you need:
| Variable | Keel default | What it colours |
|---|---|---|
accent | #5B5BF7 | Primary buttons, links, focus rings, the active switch |
accent-hover | #4343D9 | Primary buttons on hover |
brand | #121A33 | Selected and active states: the active menu entry, active chips and tabs, counts |
brand-soft | rgba(18,26,51,.07) | Light background of hovered and selected rows and menu entries |
brand-soft2 | rgba(18,26,51,.14) | A slightly stronger version, for pressed and selected items |
soft | #F4F5F9 | The page background behind the cards |
line | #E2E5EC | Borders and dividers |
r | 14px | Corner radius of cards, buttons and inputs |
All other theme variables (text, surfaces, messages, older names, font)
Text and surfaces:
| Variable | Keel default | What it colours |
|---|---|---|
ink |
#121A33 |
Headings and strong text |
text |
#2E3754 |
Normal text |
muted |
#5E6880 |
Secondary text: hints, dates, labels |
surface |
#fff |
Cards, panels, the editor, the menu |
surface-2 |
#FAFAFA |
Table heads and inner boxes |
line-strong |
#CCC |
Stronger borders: inputs, outlined buttons |
white |
#fff |
Text on coloured buttons |
shadow |
0 10px 30px rgba(0,0,0,.08) |
Shadow of cards and panels |
accent-text |
the accent, a bit darker | Links and accent-coloured text (kept readable) |
brand-text |
the brand | Text in the brand colour |
Messages and scores:
| Variable | Keel default | What it colours |
|---|---|---|
ok / ok-bg |
#2E6B22 / #EAF5E5 |
Success text and its tinted background |
warn / warn-bg |
#8A5A12 / #FFF4DE |
Warnings |
bad / bad-bg |
#B71C1C / #FDECEC |
Errors and delete buttons |
Older names (kept for existing themes; Customize sets them from accent and brand):
| Variable | Keel default | What it colours |
|---|---|---|
sky |
#5B5BF7 |
Focus borders of editor fields, the "unsaved" mark, info icons |
blue |
#4343D9 |
Text links inside cards and the editor, checkboxes |
green |
#121A33 |
The publish switch when on, chosen cards in Customize |
lime |
#1FA67F |
The main image in a gallery, "new" marks |
grad |
linear-gradient(#5B5BF7, #5B5BF7) |
Filled accent areas: primary buttons, the active tab line, the highlighted tile (may be a real gradient) |
grad2 |
linear-gradient(#121A33, #121A33) |
Filled brand areas: active chips, tags, the activity chart bars |
kd-font |
system-ui, -apple-system, Roboto, sans-serif |
The font. It must already be loaded in the admin. |
Other variables in Keel's stylesheet belong to single components and are not meant for themes.
Dark mode
Dark mode keeps accent, brand, grad, grad2 and r. It replaces the surfaces, lines, text colours, brand-soft, ok, warn, bad and shadow with its own dark values, so dark mode stays readable whatever the light theme is.
What admins change in Customize
In Customize → Theme, admins pick a preset (Project means the colours from keel.yaml, then Ocean, Indigo, Emerald, Violet, Sunset, Rose, Graphite), or set their own accent, brand, background and corners. They can save up to 20 presets of their own.
A theme saved in Customize wins over keel.yaml for the variables it sets (accent, accent-hover, brand, brand-soft, brand-soft2, soft, line, sky, blue, green, grad, grad2, r). Choosing the Project preset, or Reset to automatic, brings back the keel.yaml colours. See Customize.