vrr/Pulse
2
0
Fork 0
mirror of https://github.com/rcourtman/Pulse.git synced 2026-07-09 16:00:59 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 7
Pulse/docs/MIGRATION_UNIFIED_NAV.md
rcourtman 4ef6caaa9d Finalize v6 GA release packet
2026-06-03 17:15:00 +01:00

4.4 KiB
Raw Blame History

Migration Guide: Unified Navigation

This migration has been reverted as of v6.0.0-rc.6. Pulse v6 ships with the platform-shaped top-level navigation existing v5 operators already know (Proxmox, Docker, Kubernetes, TrueNAS, vSphere, Machines, plus Alerts, Patrol, and Settings). The unified /infrastructure / /workloads / /storage / /recovery layout that briefly shipped across rc.1 through rc.5 is retired. The unified resource model and /api/resources contract remain on the backend.

If you have automation, bookmarks, or runbooks targeting the unified routes, point them at the platform-shaped equivalents instead:

  • /infrastructure?source=pmg → /proxmox/mail-gateway (or the relevant Proxmox sub-page)
  • /workloads?type=k8s → /kubernetes
  • /storage → the platform-shaped Storage views on each platform page
  • /recovery → the platform-shaped Recovery / Backups views on each platform page (the underlying /api/recovery/* contract is unchanged)

The keyboard shortcuts follow the platform-shaped shape:

  • g p Proxmox, g d Docker, g k Kubernetes, g n TrueNAS, g v vSphere, g s Machines
  • g a Alerts, g r Patrol, g t Settings, ? shortcuts help

The "Classic shortcuts" bar referenced in the historical content below is not part of the shipped product; ignore that aid.

The rest of this document is preserved as historical context for the rc.1 through rc.5 line.

Historical context (rc.1 through rc.5 only)

The content below describes the unified-navigation migration that shipped across rc.1 through rc.5 and was reverted in rc.6. It is kept as a historical record so links from earlier release notes still resolve. None of it describes the shipped product as of rc.6 or later.

What Changed (historical)

  • Navigation was organized by task (Infrastructure, Workloads, Storage, Recovery) instead of by platform.
  • Legacy pages (Proxmox Overview, Hosts, Docker, Services, Kubernetes) were replaced by unified views.
  • Global search and keyboard shortcuts make navigation faster across all resources.
  • Kubernetes was split by intent:
    • Infrastructure showed Kubernetes clusters and nodes.
    • Workloads showed Kubernetes pods with the same filters/grouping as VMs and containers.

Why This Change (historical)

  • A unified resource model enables one inventory and one search across platforms.
  • Filters, drawers, and workflows stay consistent, instead of being re-implemented per platform page.
  • New integrations can be added without expanding the top-level navigation indefinitely.

Legacy Aliases and Redirects (historical)

  • Legacy aliases have been fully removed; update bookmarks and runbooks to canonical routes.
  • Optional migration aid: enable the Classic shortcuts bar in the main navigation (Settings → System → General).
  • Plan automation/bookmarks to use canonical routes now:
    • /infrastructure?source=pmg
    • /workloads?type=k8s

Where Old Pages Moved (historical)

Legacy Page New Location (rc.1-rc.5)
Proxmox Overview /infrastructure
Hosts /infrastructure
Docker /workloads (containers) + /infrastructure (hosts)
Proxmox Storage /storage
Proxmox Backups /recovery
Proxmox Replication /recovery?view=events&mode=remote
Proxmox Ceph /ceph (summary also visible in Storage)
Proxmox Mail Gateway /infrastructure?source=pmg
Services /infrastructure?source=pmg
Kubernetes /workloads?type=k8s

New Features to Know (historical)

Global Search

  • Press / to focus search.
  • Search by name, node, type, tags, or status.
  • Results navigate directly to the relevant view.
  • Use Cmd/Ctrl+K for the command palette.

Keyboard Shortcuts (historical, rc.1-rc.5 shape)

  • g i → Infrastructure
  • g w → Workloads
  • g s → Storage
  • g b → Recovery
  • g a → Alerts
  • g t → Settings
  • ? → Shortcut help

Debug Drawer (Optional)

  • Enable with localStorage key pulse_debug_mode for raw JSON in resource drawer.

Tips (historical)

  • If you used Docker and Hosts pages before, start with Infrastructure (hosts) and Workloads (containers).
  • If you used the Kubernetes page before, use Infrastructure for cluster/node health and Workloads for pod-level operations.
  • The new pages support unified filters, tags, and search across all sources.