Self-hosted homelab infrastructure visualizer — interactive network diagram with live status monitoring
TypeScript diagramhomelabhomelab-infrastructure-observabilitynetworkproxmox-veself-hostedzigbeezwavezwave-js
feat(walkthrough): introduce the rack canvas, and keep Next inside the card
Pouzora70fc248bf6d
diff --git a/frontend/src/components/panels/Sidebar.tsx b/frontend/src/components/panels/Sidebar.tsxindex 049d9e0..d4cc60e 100644--- a/frontend/src/components/panels/Sidebar.tsx+++ b/frontend/src/components/panels/Sidebar.tsx@@ -172,6 +172,7 @@ export function Sidebar({ onAddNode, onAddGroupRect, onAddText, onScan, onZigbee<div className="px-2 pt-2 pb-1 border-b border-border relative"><buttononClick={() => setDesignSwitcherOpen((o) => !o)}+ data-tour="canvas-switcher"className="flex items-center gap-2 w-full px-2 py-1.5 rounded-md text-xs font-medium bg-[#21262d] border border-border hover:border-[#30363d] transition-colors cursor-pointer">{activeDesignId ? (() => {diff --git a/frontend/src/components/panels/__tests__/Sidebar.test.tsx b/frontend/src/components/panels/__tests__/Sidebar.test.tsxindex 45e11b6..afbdf78 100644--- a/frontend/src/components/panels/__tests__/Sidebar.test.tsx+++ b/frontend/src/components/panels/__tests__/Sidebar.test.tsx@@ -284,6 +284,38 @@ describe('Sidebar', () => {expect(mockLogout).toHaveBeenCalledOnce()})})++ // ── Walkthrough anchor ─────────────────────────────────────────────────────++ it('carries the walkthrough anchor the rack tour step spotlights', async () => {+ const { useDesignStore } = await import('@/stores/designStore')+ const { STEPS } = await import('@/walkthrough/steps')+ const before = useDesignStore.getState()+ useDesignStore.setState({+ designs: [{+ id: 'd1', name: 'Main', design_type: 'network', icon: null,+ created_at: '2026-01-01T00:00:00Z', updated_at: '2026-01-01T00:00:00Z',+ }],+ activeDesignId: 'd1',+ loaded: true,+ })++ const { unmount } = render(<Sidebar {...defaultProps} />)++ const step = STEPS.find((s) => s.id === 'rack')+ expect(step?.anchor).toBe('[data-tour="canvas-switcher"]')+ // The overlay resolves that selector against the DOM — an anchor the sidebar+ // stops carrying leaves the step spotlighting nothing.+ expect(document.querySelector(step!.anchor!)).toBeInTheDocument()++ // Unmount before restoring, so the store reset never re-renders the sidebar.+ unmount()+ useDesignStore.setState({+ designs: before.designs,+ activeDesignId: before.activeDesignId,+ loaded: before.loaded,+ })+ })})// ── Standalone mode ────────────────────────────────────────────────────────────diff --git a/frontend/src/walkthrough/WalkthroughOverlay.tsx b/frontend/src/walkthrough/WalkthroughOverlay.tsxindex 05e5359..3ccebc2 100644--- a/frontend/src/walkthrough/WalkthroughOverlay.tsx+++ b/frontend/src/walkthrough/WalkthroughOverlay.tsx@@ -207,18 +207,20 @@ export function WalkthroughOverlay() {)}<div className="mt-3 flex items-center justify-between gap-2">- {/* Progress dots */}- <div className="flex items-center gap-1.5">+ {/* Progress dots. The strip grows with the step count, so it is the+ part that gives: it shrinks and clips rather than pushing Next out+ of the fixed-width card. */}+ <div data-testid="walkthrough-progress" className="flex min-w-0 flex-1 items-center gap-1 overflow-hidden">{steps.map((s, i) => (<spankey={s.id}- className={`h-1.5 rounded-full transition-all ${+ className={`h-1.5 shrink-0 rounded-full transition-all ${i === stepIndex ? 'w-4 bg-[#00d4ff]' : 'w-1.5 bg-[#30363d]'}`}/>))}</div>- <div className="flex items-center gap-1.5">+ <div className="flex shrink-0 items-center gap-1.5"><span className="mr-1 text-[10px] font-mono text-muted-foreground">{stepIndex + 1}/{steps.length}</span>diff --git a/frontend/src/walkthrough/__tests__/WalkthroughOverlay.test.tsx b/frontend/src/walkthrough/__tests__/WalkthroughOverlay.test.tsxindex 3c21c75..1cd6869 100644--- a/frontend/src/walkthrough/__tests__/WalkthroughOverlay.test.tsx+++ b/frontend/src/walkthrough/__tests__/WalkthroughOverlay.test.tsx@@ -36,6 +36,20 @@ describe('WalkthroughOverlay', () => {expect(screen.getByText('Welcome to Homelable')).toBeInTheDocument()})+ it('lets the progress strip give way, not the Next button', () => {+ renderWithProviders(<WalkthroughOverlay />)+ startTour()++ const dots = screen.getByTestId('walkthrough-progress')+ expect(dots.children).toHaveLength(TOTAL)+ // The card is a fixed 320px, so one dot per step eventually outgrows the+ // footer. The strip shrinks and clips; the counter and buttons hold their+ // size, or Next lands outside the card.+ expect(dots.className).toContain('min-w-0')+ expect(dots.className).toContain('overflow-hidden')+ expect(screen.getByText('Next').closest('div')?.className).toContain('shrink-0')+ })+it('skip closes the overlay', () => {renderWithProviders(<WalkthroughOverlay />)startTour()diff --git a/frontend/src/walkthrough/__tests__/steps.test.ts b/frontend/src/walkthrough/__tests__/steps.test.tsindex b654943..7ad7c4b 100644--- a/frontend/src/walkthrough/__tests__/steps.test.ts+++ b/frontend/src/walkthrough/__tests__/steps.test.ts@@ -12,13 +12,26 @@ describe('getSteps', () => {expect(standalone.length).toBeLessThan(STEPS.length)const ids = standalone.map((s) => s.id)// Canvas-only steps survive; backend-only steps are filtered out.- expect(ids).toEqual(expect.arrayContaining(['welcome', 'nodes', 'grouping', 'style', 'end']))+ expect(ids).toEqual(expect.arrayContaining(['welcome', 'nodes', 'grouping', 'rack', 'style', 'end']))expect(ids).not.toContain('scan')expect(ids).not.toContain('scan-history')expect(ids).not.toContain('inventory')expect(ids).not.toContain('imports')})+ it('keeps the rack step in both modes — a rack canvas needs no backend', () => {+ const rack = STEPS.find((s) => s.id === 'rack')+ expect(rack?.mode).toBe('all')+ expect(rack?.anchor).toBe('[data-tour="canvas-switcher"]')+ expect(getSteps(true).map((s) => s.id)).toContain('rack')+ })++ it('introduces the rack canvas before the styling step', () => {+ const ids = STEPS.map((s) => s.id)+ expect(ids.indexOf('rack')).toBeGreaterThan(ids.indexOf('nodes'))+ expect(ids.indexOf('rack')).toBeLessThan(ids.indexOf('style'))+ })+it('ends on a step with a GitHub link (the full-mode recap in standalone)', () => {const last = getSteps(true).at(-1)expect(last?.id).toBe('end')diff --git a/frontend/src/walkthrough/steps.ts b/frontend/src/walkthrough/steps.tsindex 4fc2100..68c1100 100644--- a/frontend/src/walkthrough/steps.ts+++ b/frontend/src/walkthrough/steps.ts@@ -87,6 +87,14 @@ export const STEPS: TourStep[] = [action: 'selectTwoNodes',mode: 'all',},+ {+ id: 'rack',+ title: 'Map the physical side',+ body: 'A canvas can also be a Rack: real racks, the gear mounted in them, and the patch cables between their ports. Create one from the canvas switcher (New Canvas, Kind: Rack), drop a rack, mount devices with + Device, then hit Patch and drag from one port to another.',+ anchor: '[data-tour="canvas-switcher"]',+ placement: 'right',+ mode: 'all',+ },{id: 'style',title: 'Make it yours',