Config Reference

`Decorations`

Managed borders, border resize, and compositor-owned titlebars with the 0.7 neutral-and-orange defaults.

Defaults

Defaults shown here are the effective built-in defaults for the selected wiki version.

Default Config Shape

Use this as the section shape when editing halley.rune.

decorations:
  border:
    size 3
    radius 8
    colour-focused "#f4f5f7"
    colour-unfocused "#474d59"
  end
  resize-using-border true
  titlebars:
    enabled true
    button-position "right"
    title-position "center"
    show-buttons true
    show-icons false
    show-title true
    height 32
    colour-focused "#d65d26"
    colour-unfocused "#474d59"
  end
end

`decorations`

Window chrome groups.

Option	Type	Default	Notes
`border`	nested block	`see decorations.border`	Primary compositor border.
`resize-using-border`	bool	`true`	Enables edge and corner resize hit areas.
`titlebars`	nested block	`see decorations.titlebars`	Chrome for server-decorated windows.

`decorations.border`

Primary managed-window border.

Option	Type	Default	Notes
`size`	i32	`3`	Border width in output pixels.
`radius`	i32	`8`	Client-content corner radius.
`colour-focused`	hex RGB	`#f4f5f7`	Focused border color; 0.7 defaults to neutral near-white.
`colour-unfocused`	hex RGB	`#474d59`	Unfocused border color.

`decorations.titlebars`

Server-side titlebar layout and palette.

Option	Type	Default	Notes
`enabled`	bool	`true`	Draws titlebars for server-decorated windows.
`button-position`	left \| right	`right`	Control button group side; 0.7 places controls on the right by default.
`title-position`	left \| center \| right	`center`	Title and app-icon group alignment.
`show-buttons`	bool	`true`	Shows close, maximize, and minimize controls.
`show-icons`	bool	`false`	Shows the app icon beside the title.
`show-title`	bool	`true`	Shows the window title.
`radius`	i32	`8`	Titlebar corner radius.
`height`	i32	`32`	Requested titlebar height.
`colour-focused`	hex RGB	`#d65d26`	Focused background; 0.7 uses Halley orange.
`colour-unfocused`	hex RGB	`#474d59`	Unfocused background.
`foreground-colour-focused`	hex RGB	`#101418`	Focused title and icon color.
`foreground-colour-unfocused`	hex RGB	`#f4f5f7`	Unfocused title and icon color.
`button-hover-colour`	hex RGB	`#ffffff`	Control hover color.
`button-pressed-colour`	hex RGB	`#101418`	Control pressed color.