Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/xXmizzeryXx/zenodeployment/llms.txt

Use this file to discover all available pages before exploring further.

Zeno stores every visual preference in localStorage and applies them on load before the first frame is painted, so the dashboard always opens exactly as you left it. This page covers all available customization options: accent colors, wallpapers, background effects, desktop mode, and interface toggles.

Accent color

The accent color controls glows, borders, card highlights, and the cursor trail throughout the entire interface. To change it:
1

Open the accent picker

Click the ACCENTS button in the bottom bar of the dashboard. The accent modal opens.
2

Choose a preset or enter a custom hex value

Select one of the eight built-in swatches, or type a hex value into the custom input field. The interface updates live as you pick.
3

Apply

Click APPLY to save. The accent is written to localStorage under zeno-accent-color. Click CANCEL to revert to the saved value.
The built-in preset swatches are:
NameHexRGB
Cyan (default)#00f5ff0, 245, 255
Purple#bf00ff191, 0, 255
Pink#ff006e255, 0, 110
Green#00ff880, 255, 136
Yellow#ffe600255, 230, 0
Orange#ff8c00255, 140, 0
White#ffffff255, 255, 255
Red#ff4444255, 68, 68
The accent can also be changed directly in Settings → Personalization → System Accent Color without opening the full modal. The Settings page shows a condensed five-swatch color row (Cyan, Pink, Purple, Green, Gold).

Wallpaper

1

Open the wallpaper picker

Click the WALLPAPER button in the bottom bar.
2

Pick a preset or paste a URL

Select a built-in swatch or paste any direct image URL into the custom URL field. A preview is not shown in the modal, but the wallpaper applies immediately when you confirm.
3

Adjust the darken slider

Use the Darken slider to add an extra dark overlay on top of the wallpaper for improved text contrast. The value is saved to zeno-wp-scrim and applied via the CSS variable --wp-extra-dim.
4

Apply or remove

Click APPLY to save the wallpaper URL to zeno-wallpaper. Click REMOVE to clear the wallpaper entirely.

Automatic contrast adaptation

After a wallpaper is applied, Zeno samples the image at 80 × 80 pixels and computes the average perceived luminance using the ITU-R BT.709 formula. Based on the result, it sets a data-wp-theme attribute on <body>:
Theme valueConditionEffect
darkAverage luminance < 80Subtle dark scrim; neon text is kept
lightAverage luminance > 180Heavy white scrim; text switches to dark colors
mixed80–180Frosted dark scrim; neon text is kept
The detected theme is cached to zeno-wallpaper-theme so the correct scrim appears instantly on the next page load without waiting for the image to re-download.
If the image host blocks cross-origin canvas reads, Zeno falls back to the dark scrim, which is safe for most wallpapers.

Background effects

Zeno’s default background is a dark field with a subtle grid overlay, ambient glow, and CRT scanlines. Each element can be toggled independently in Settings → Personalization:
SettinglocalStorage keyDefault
Grid backgroundzeno-bg-gridOn
Scanlines effectzeno-bg-scanlinesOn
Interface blur (glassmorphism)zeno-bg-blur20
The blur slider controls the --glass-blur CSS variable, which sets the backdrop-filter intensity on cards and modals.

Desktop mode

Enable desktop mode in Settings → Interface → Desktop Mode to switch from the centered launcher card to a full-screen OS-style layout. The preference is saved to zeno-desktop-mode. Desktop mode changes:
  • App icons spread across the full viewport rather than staying centered.
  • The top header (clock and greeting) moves into the taskbar system tray.
  • A taskbar appears at the bottom with a start button, pinned app icons, and a clock.
  • Apps open in draggable, resizable windows instead of navigating to a new page.
  • A widget panel appears in the top-right corner with a clock widget and system stats.
See Dashboard overview for a complete description of all desktop mode features.

Username

Your display name is shown in the greeting on the dashboard and in the start menu footer in desktop mode. It is set at first launch via a welcome prompt. To update it later, go to Settings → Personalization → Display Name, edit the field, and click SAVE CHANGES. The name is stored under zeno-username. If the value is empty, the greeting falls back to a plain HELLO, with no name shown.

Clock layout

Click the swap button () beside the clock on the dashboard to toggle whether the date appears above or below the time. The layout is stored in zeno-clock-date-first ("1" for date-first).

Reduced motion

For users who prefer less animation, enable Settings → Interface → Reduced Motion. This sets zeno-reduced-motion to true and applies the following globally:
*, *::before, *::after {
  animation-duration: 0.01ms !important;
  transition-duration: 0.01ms !important;
}
The cloak badge pulse and app icon breathing animations are also suppressed. Zeno also respects the browser’s prefers-reduced-motion media query automatically, even if the setting is not explicitly toggled.

App grid order

To rearrange the app icons on the dashboard, hold Alt and drag any icon to a new position. The order is saved to zeno-app-order as a JSON array of app IDs and is restored on every visit.
All customization keys are stored in localStorage on your current browser profile. To transfer your setup to another browser, export your localStorage values or use a browser sync feature. A factory reset (Settings → Danger Zone → Reset All) wipes all keys at once.

Build docs developers (and LLMs) love