theme.rk
Layer 6: colours, type and density for an installation or one organisation. Starts from a template (extends) and overrides tokens. Light and dark are always both produced; overriding one colour derives its dark pair unless given.
Lives in <site>/themes/<name>.rk · Schema theme.json (source) · first line: # yaml-language-server: $schema=https://rangka-os.github.io/rangka-os/schema/0.5/theme.json
Properties
| Property | Type | Meaning |
|---|---|---|
name required | name | snake_case, never renamed once released pattern ^[a-z][a-z0-9_]{0,62}$ |
label | label | A label in Bahasa Indonesia (required) and optionally English. |
label.id required | string | |
label.en | string | |
extends | string | Template, e.g. rangka/standard, rangka/retail, rangka/clinic default "rangka/standard", pattern ^[a-z0-9_-]+/[a-z0-9_-]+$ |
mode | light · dark · system | default "system" |
color | map of string or object | Token overrides by token name (primary, selected, brand, chart-1…). A string sets light and derives dark; an object sets both. |
font | object | |
font.sans | string | |
font.display | string | |
font.mono | string | |
radius | sharp · standard · round | default "standard" |
density | compact · standard · comfortable | default "standard" |
logo | object | |
logo.light | string | |
logo.dark | string | |
logo.mark | string | |
contrast_check | boolean | Refuse overrides that drop text below 4.5:1 or controls below 3:1 default true |
Example
From rangka-apps/examples/sites/kopi-senja/themes/kopi_senja.rk (first 60 lines):
yaml
# yaml-language-server: $schema=https://rangka-os.github.io/rangka-os/schema/0.5/theme.json
name: kopi_senja
label: {id: Kopi Senja}
extends: rangka/standard
mode: system
color:
brand: '#9a5b2e'
chart-1: '#0c66e4'
radius: standard
density: standardGenerated from the schema by website/scripts/gen-reference.mjs. Edit the schema, not this page.