v1.0.0 - Home Topology Mapper

Home Topology Mapper v1.0.0

First stable release of Home Topology Mapper — a self-hosted tool for visualising and managing your home LAN topology.

Core Capabilities

Device Discovery & Identity

• nmap-based LAN scanning (quick / full modes)
• MAC-first device identity matching with IP-change handling
• Configurable device-type heuristics (router, server, phone, camera, IoT, etc.)
• Structured scan error reporting with actionable hints in the Dashboard

Topology Editor

• Drag-and-drop canvas powered by React Flow
• Node editor: set custom labels and icons per device
• Edge editor: mark links as Ethernet / WiFi / Unknown
• Explicit link deletion with confirmation dialog
• Screenshot/share mode — one-click full-screen clean view, print-ready

Persistence & Incremental Scans

• Manual edges marked confirmed_by_user=True are preserved across all future scans
• Newly discovered devices appear in a visible Unclassified bin, separate from confirmed topology
• Pinned node positions survive re-scans

Offline Device Policy

• Devices do not disappear immediately when they go offline
• Configurable retention window via HTM_OFFLINE_RETENTION_DAYS environment variable
• Stale (long-offline) devices rendered with greyed-out / archived style

LXC / PVE Diagnostics

• Startup pre-flight checks for: nmap presence, NET_RAW capability, host network routing, subnet reachability
• Diagnostic results surfaced in the Dashboard with fix hints

Docker / Deployment

• Production-ready docker-compose.yml with healthcheck and restart policy
• Fully documented .env.example covering all tuneable settings
• Designed for Proxmox LXC with host networking

Verified

• python3 -m compileall app — exit 0
• pytest — 31/31 passed

pm run build — vite build exit 0, 323 kB bundle

• docker-compose.yml YAML valid

Merged PRs

#23\ scan-nmap-mvp · #24\ device-identity-merge · #25\ device-type-heuristics · #26\ scan-error-ui · #27\ preserve-manual-edges · #28\ new-device-bin · #29\ offline-device-policy · #30\ topology-node-editor · #31\ topology-edge-editor · #32\ topology-delete-link · #33\ topology-screenshot-mode · #34\ lxc-permission-checks · #35\ compose-production-polish