Skip to main content
Keel Docs Showcase

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

KeyDefaultWhat it does
titleDashboardTab and header title
subtitleContent dashboardSmaller text under the title
logonone (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

yaml
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:

VariableKeel defaultWhat it colours
accent#5B5BF7Primary buttons, links, focus rings, the active switch
accent-hover#4343D9Primary buttons on hover
brand#121A33Selected and active states: the active menu entry, active chips and tabs, counts
brand-softrgba(18,26,51,.07)Light background of hovered and selected rows and menu entries
brand-soft2rgba(18,26,51,.14)A slightly stronger version, for pressed and selected items
soft#F4F5F9The page background behind the cards
line#E2E5ECBorders and dividers
r14pxCorner 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.