Skip to content

Themes and layouts ​

Look and structure are metadata: a theme or layout extends a template and overrides only what differs, so every organisation starts from a tested standard. Light and dark are always both produced.

Themes ​

yaml
# themes/kopi_senja.rk
name: kopi_senja
extends: rangka/standard     # rangka/retail, rangka/clinic
mode: system                 # light | dark | system
color:
  brand: '#9a5b2e'           # a string sets light and derives dark
  chart-1: {light: '#0c66e4', dark: '#579dff'}   # or set both modes yourself
radius: standard             # sharp | standard | round
density: standard            # compact | standard | comfortable
  • rangka/standard is the Rangka base: Ink (#1C1917) primary buttons, deep Bata (#A33B23) links and selection on a Kapur (#F6EDE6) tint, a Bata Terang (#E0623F) focus ring, warm stone neutrals; danger stays red. A company theme overrides only what it needs, like the coffee brand and the first chart colour above.
  • Tokens are the design system's names: primary, selected, selected-ink, brand, link, chart-1 … chart-6.
  • Dark derivation: a colour given once keeps its hue; backgrounds and tints go to lightness 100 − L·0.6, accents gain 15 lightness, then contrast floors apply.
  • Contrast is enforced: the validator refuses a theme whose text drops below 4.5:1 or whose controls drop below 3:1 in either mode (low_contrast).

Reference: theme.rk.

Layouts ​

yaml
# layouts/crm_first.rk
name: crm_first
extends: rangka/top-nav
shell: top-nav               # side-only (default) | top-nav | pos | portal
home: dashboard:crm_overview
nav:
  top:
    - {to: 'dashboard:crm_overview', label: {id: Dasbor}}
    - {to: 'model:deal', label: {id: Peluang}}
  create: [deal, lead, sales_invoice]
  app_switcher: true
pages:
  - name: pagi_ini
    label: {id: Pagi ini}
    blocks:
      - {block: page_header, props: {title: Pagi ini}}
      - block: columns
        children:
          - {block: number, span: 4, props: {dashboard: crm_overview, widget: pipeline}}
          - {block: list, span: 8, props: {dashboard: crm_overview, widget: activities_due}}

The default shell is side-only, a Frappe-style sidebar; a site without a layout gets it too (contract 0019). top-nav puts the app switcher and search in a bar above the sidebar. pos and portal show the sidebar until those shells are built.

A page is a tree of UI blocks — page_header, list, board, form, dashboard, number, chart, table, markdown, filter_bar, tabs, columns, empty_state, embed — on a 12-column grid. Each block is a design-system component; its props come from the metadata. Reference: layout.rk.

Templates ship in rangka-os/templates/themes and templates/layouts.

Rangka OS is source-available under the Elastic License 2.0 (ELv2). Free to self-host.