Skip to content

feat(nodes): the node's OS as its card's logo, details on a click - #154

Merged
hiddify-com merged 1 commit into
hiddify:devfrom
Hiddify-Official:feat/node-os-logo
Nov 1, 2026
Merged

hiddify-com merged 1 commit into
hiddify:devfrom
Hiddify-Official:feat/node-os-logo

Conversation

@Hiddify-Official

Copy link
Copy Markdown
Contributor

Problem

Every node card on the Nodes page had the same generic server glyph, and the panel did not know which operating system a node's server runs. Admins asked for the OS's logo on the card, and its name and version on a click, without leaving the page.

Change

  • Node side
    • hutils/system_metrics.py: os_info() reads /etc/os-release (ID, NAME, VERSION_ID, PRETTY_NAME), the kernel release and the architecture, once per process.
    • dashboard_schema.py: DashboardHost gets os_id, os_name, os_version, os_pretty, kernel and arch. They default to empty, so a node of an older version still validates.
  • Parent side
    • nodes_api.py: new GET nodes/<id>/os/ (super admin). It asks the node's own dashboard (include=system) with the parent's key and caches the answer in redis for an hour (an empty answer for 5 minutes).
  • UI
    • features/nodes/os-logos.ts: 14 logos as SVG paths with their brand colours, from Simple Icons 16.36.0 (CC0). No new dependency: only these paths are vendored. /etc/os-release IDs are mapped to them; any other Linux gets Tux.
    • NodesView.vue: the card's icon is a button showing the OS logo as a soft app icon.
      • Look: a tile tinted with the brand colour, with a gloss and a fine border, and the logo in the brand colour. In the dark theme there is a lighter colour for the black and navy brands (AlmaLinux, CentOS).
      • Hover only: the logo turns and bounces, and a band of light sweeps across. Disabled with prefers-reduced-motion.
      • Click: a Popover shows the OS name, version, kernel and architecture.
      • Unknown OS: the old glyph stays.
    • nodes.os.* strings in 7 languages.

Screenshots

Before After
before after

On a click: popup

Dark theme: dark

Hover: motion

All logos, light and dark: logos

Tested

  • On main (parent), with every server deployed and restarted:
    • node2 shows Ubuntu 26.04 LTS with its kernel and x86_64, which matches its /etc/os-release;
    • node1 is unreachable, so it keeps the old glyph;
    • no errors in the panel log.
  • The animation runs only on :hover: the built CSS has it only there, and a browser check reported none without the mouse.
  • All 14 tiles were rendered locally in light and dark. vue-tsc: no errors in the changed files.

Review

  • Confidence: Needs review — it adds a field to the dashboard host schema that nodes send to the parent, and a parent-to-node call. Please check the parent key and caching in node_os(); old nodes simply leave the fields empty.
  • Complexity: Complex — parent/child (a node reports, the parent asks), plus the UI.

🤖 Generated with Claude Code

…a tap

The card's icon was the same server glyph for every node. A node's panel now
reports its operating system in the dashboard's host info (/etc/os-release:
ID, NAME, VERSION_ID, PRETTY_NAME; kernel and architecture), and the new
nodes/<id>/os/ asks a node for it with the parent's key (kept an hour).

The card shows the OS as an app icon in the panel's soft style (Ubuntu,
Debian, CentOS, Rocky, Alma, Fedora, Alpine, Arch, openSUSE, Red Hat, Mint,
Gentoo, FreeBSD; Tux for any other Linux; the old glyph when not known): a
tile tinted with the brand colour, a gloss and a fine border, the logo in
the brand colour (a lighter one in the dark theme for black / navy brands).
With the mouse on it the logo turns and bounces and a band of light sweeps
the tile. A tap opens a small popover with the OS, its version, the kernel
and the architecture. Logos from Simple Icons (CC0).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

🥷 Ninja i18n – 🛎️ Translations need to be updated

Project /project.inlang

lint rule new reports level link
Identical pattern 6 warning contribute (via Fink 🐦)

@hiddify-com
hiddify-com merged commit 09c4a55 into hiddify:dev Nov 1, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants