Appearance
Services & cards
A service is a card on a page. It has a name, an icon, a link, an optional Docker container link, and up to three widgets.
Adding a service
Click Add service in the top bar and fill in the dialog:
| Field | Notes |
|---|---|
| Name | Card title |
| Description | Subtitle under the name |
| URL | Where the card links when clicked |
| Icon | Built-in name, sh-/si- icon, or image URL (icon rules) |
| Container | Docker container name - links the card to a container for live status & controls |
| Server / host | Free-text label for which host the container runs on |
| Widget | The primary widget type + its credentials |
| Page → Group | Where the new card lands |
| Accent colour | Tile colour used when no image icon is set |
Editing a service
Hover a card and click the pencil, or open it from the command palette. The same dialog opens, pre-filled. From here you can change any field, swap the widget type, add more widgets, or delete the service.
Credentials are write-once-safe
Password / key / token fields show a "leave blank to keep" placeholder when editing. Leave them empty to keep the saved secret; type a new value to replace it. Secrets are stored server-side and are never sent back to the browser.
The card itself
A service card shows:
- The tile (icon or coloured monogram), name and description
- A small container tag if you linked a Docker container
- A status dot (up / warn / down)
- On hover: a star (pin to Dashboard) and a pencil (edit)
- Any widget bodies stacked below the header
Drag & drop
- Reorder - drag a card within its group.
- Move between groups - drag a card onto another group, or onto a group's empty drop area.
Favourites
Tap the star on any card to pin it to the Dashboard's Favourites row. Tap again to unpin. Favourites can be dragged to reorder on the Dashboard.
Status & Docker
If you set a Container name and have a Docker proxy configured, the card's status dot reflects the container's real state, and you can start / stop / restart it from the Docker settings tab.