VNOX-Client/docs/04-clients/themes.md
loki5512344 8e5ab56611
feat(client): redesign native UI, themes, settings and avatars
Separate conversation drafts and voice view state, add native settings and restricted CSS themes, implement validated avatar cropping, and refresh dependencies with documented desktop compatibility backports.
2026-10-24 14:23:48 +02:00

3.2 KiB
Raw Permalink Blame History

Themes and appearance

Open Settings → Appearance to choose Light, Dark, Mega-dark or Custom. The same palette applies to chat, voice rooms, settings, dialogs and profile unlock. Text size ranges from 12 to 22 px; smaller metadata remains at least 11 px.

Custom CSS format

Vnox is a native Slint application. Its theme files accept a restricted CSS custom-property format, not a browser stylesheet. Exactly one :root { … } block is allowed; comments are supported. Selectors, layout rules, @import, url(), scripts, external resources and unknown/duplicate variables are rejected. Files must have a .css extension and contain at most 16 KiB of UTF-8 text.

:root {
  --vnox-bg: #242424;
  --vnox-text: #eeeeee;
  --vnox-accent: #c8b797;
  --vnox-font-size: 17px;
}

Unspecified colors inherit the standard dark palette. For a complete starting point, export a built-in theme or edit forest.css. Colors support #RGB, #RGBA, #RRGGBB and #RRGGBBAA (alpha comes last). Font size must be a finite number from 12px to 22px.

Variable Controls
--vnox-bg Main content background
--vnox-surface Sidebar and settings surfaces
--vnox-rail Server rail and slider tracks
--vnox-hover Hover backgrounds
--vnox-elevated Raised sections and profile surfaces
--vnox-input Inputs and controls
--vnox-selected Selected rows and text selection
--vnox-border Borders and dividers
--vnox-accent Focus, actions and accents
--vnox-text Primary text
--vnox-text-secondary Supporting text
--vnox-text-muted Metadata and hints
--vnox-text-disabled Disabled/de-emphasized text
--vnox-danger Destructive actions and errors
--vnox-success Voice and success states
--vnox-font-size Base text size

Preview, save and files

Built-in choices apply and save immediately. Selecting Custom opens its editor. Preview validates and applies the editor contents without saving; closing settings restores the last saved palette. Apply saves the custom theme. Reset restores the standard dark theme and default custom template.

The custom text-size slider updates the CSS preview; apply it to save. Import reads a local .css file and previews it. Export writes validated CSS to the specified path, replacing that file if it already exists. No theme data is sent over the network. Appearance preferences live in the platform config directory at vnox/appearance.json; the default import/export path is vnox/custom-theme.css in that directory.

Profile photos

Settings → Identity offers a native photo picker, square crop with circular preview, drag/pan, zoom and confirm/cancel. PNG, JPEG and static WebP are accepted; SVG and animated images are rejected. Encoded input is limited to 10 MiB, image sides to 4096 px, and decoding allocations to 64 MiB. EXIF orientation is applied before cropping. Confirm writes a 256×256 PNG in vnox/avatars/, scoped to the current identity. Cancel and validation/save failures preserve the old photo.

Photos currently affect the local own-profile display only. There is no server profile-photo API yet, so other users/devices do not receive these photos.