Using NasDash

Customization

Title, theme, light or dark mode, dock, logos, and advanced CSS.

Appearance settings
NasDash 0.3.6 · fictional demo data · English interface · captured 29 October 2026.
Themes and icons gallery
NasDash 0.3.6 · fictional demo data · English interface · captured 29 October 2026.

Visual settings cover the dashboard title, theme, light or dark mode, tab organization, dock, and card display.

Settings → Appearance includes the accent colour, surface blur, soft edges, outlines, widget titles and category titles. Category titles can sit above or inside their category. Start with these controls before adding CSS.

Start with the interface options. Reserve custom CSS for needs that the theme does not cover: it is more powerful but requires maintenance with each update.

For a complete identity:

  1. set the title in Settings → Header; NEXT_PUBLIC_DASHBOARD_TITLE is only a build-time fallback when no title is saved, and changing it at runtime does not rename a prebuilt image;
  2. choose the theme and mode in the settings;
  3. upload the service logos;
  4. add documented CSS only after that.

Developers have access to the Custom CSS guide and ready-to-adapt recipes, along with the ?safe-css=1 recovery mode.

Interface language

NasDash maintains English, French, Spanish, German and Italian. Choose the interface language under Settings → Appearance. On a self-hosted installation, the preference is saved in the server configuration for the entire instance. The public demo keeps changes in its isolated temporary session and accepts an explicit ?lang=it link for Italian. The website and documentation language selectors keep the chosen language when opening the other NasDash projects.

Wallpaper and fresh-install appearance

New installations use /wallpapers/nasdash-aurora.jpg, card opacity 60 %, surface blur 24 px, wallpaper veil 15 % and Lucide icons. Existing installations keep their appearance settings.

Choose from five wallpapers drawn for NasDash in Settings → Appearance → Wallpaper or in the first-start guide: aurora, dusk, mist, waves and dawn. The files are public/wallpapers/nasdash-aurora.jpg (default), public/wallpapers/nasdash-dusk.jpg, public/wallpapers/nasdash-mist.jpg, public/wallpapers/nasdash-waves.jpg and public/wallpapers/nasdash-dawn.jpg. They are generated by scripts/generate-wallpapers.mjs and distributed under the project’s licence.

Settings → Appearance → Wallpaper veil (wallpaperDim) has a slider from 0 to 60 %. It darkens the wallpaper in dark mode and lightens it in light mode so widgets and text stand out. With background blur enabled, surfaces have light translucent hairlines and increased saturation to preserve the wallpaper’s colours.

The sign-in screen and first-start guide use the dashboard’s glass settings: card opacity, surface blur, wallpaper veil and light or dark mode. Before sign-in, /api/setup exposes the glass values in glass alongside the theme, mode and wallpaper. The sign-in screen falls back to 60 % opacity for fully opaque cards and 24 px blur when blur is disabled.

Before sign-in, the screen looks like the dashboard: its theme and its wallpaper, or the theme's background when no wallpaper is set. An uploaded wallpaper is served alone by /api/setup/wallpaper (the phone one with ?screen=mobile), so anyone who can open the sign-in page can see that image; every other upload stays behind sign-in. While the dashboard loads, the wallpaper of the last visit shows.