Dashboard widgets

In the admin: Dashboard, then Add. See the Settings reference.

A widget is a small visual on the dashboard grid, for information worth a glance rather than a readout.

Each widget runs as a separate document in a sandboxed frame and fetches only from the Stackyard API. The server makes the outbound call.

Add a widget

Under Dashboard, press Add and pick Widget. Choose a type, then a card size, then fill in the fields that type needs.

Most types offer Small, some offer Medium or larger. Some fields change with the size, such as how many slots there is room for.

Widgets reorder in the same list as apps and folders. See Apps and folders.

The widgets

12 widgets

• BackupLast and next run of backup jobs.Duplicati, Kopia
• BooksReading progress and shelves.Audiobookshelf, Komga, Kavita
• ClockA digital or analog clock.No service
• ConnectionsA VPN tile, or services on a world map.Gluetun, NetBird, Conduit, Plausible, Umami
• CustomAny web page, in a frame.Any page
• Dashboard switchLinks to your other dashboards.No service
• Disk healthSMART status per drive bay.Scrutiny, TrueNAS
• DNSBlocked and total queries.AdGuard Home, Pi-hole, Technitium, NextDNS
• GitHubPull requests or a contribution graph.GitHub
• Now PlayingWhat is playing, with progress.Plex, Jellyfin, Emby, Navidrome
• System summaryCPU, memory, disk, temperature and network.This machine, Glances, Beszel, Unraid
• WeatherCurrent conditions for one place.Open-Meteo, OpenWeather

Credentials

A field marked Secret is stored on the server and never sent back to the browser. It shows as set without revealing its value.

Changing where a credential would be sent, by editing a URL or a non-secret field, clears the stored value, and Stackyard names what to re-enter. This stops an imported config from taking a credential out of an install.

Writing a widget

A widget is one folder, with no changes to the rest of the app. See Build your first widget.