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

72 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.
```css
: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](../../examples/themes/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.