Smart Bulb Dashboard

Documentation & project index.

A local, cloud-independent dashboard for Tuya-based Wi-Fi smart bulbs — no cloud round-trip for day-to-day control, a REST API underneath, and a vanilla-JS frontend with no build step. Nine pages, indexed below.

• Setup Guide guide Get a bulb's Tuya credentials (the hard part), install the backend, and run the dashboard — three ways to acquire the local key, in order of how much we recommend them.
• Features reference All 159 working features, itemized — core control, presets, scenes, effects, timers, scheduling, audio-reactive lighting, discovery, remote access, analytics, and the CLI.
• API Reference reference Full curl reference for the REST API — devices, color/brightness, scenes, effects, audio-reactive sessions, discovery, and the PIN-gate auth endpoints.
• Audio-Reactive Lighting reference All 20 interpretation modes, the measured per-stage latency budget, the hop/window design that separates decision speed from frequency resolution, and multi-bulb orchestration.
• Remote Access & Security guide Tailscale vs. DuckDNS+PIN gate, what the PIN gate actually protects against (and doesn't), and the planned adversarial security-test phase.
• Active Roadmap planning What's planned, in progress, and blocked right now — synced from real GitHub issues, not a hand-maintained list.
• Roadmap Archive planning Finished and closed work, plus the full ~1,000-item, four-week plan for reference.
• Network Graph reference The real dependency graph of this codebase — 570 nodes, 1,002 edges, generated by graphify, not drawn by hand.
• Changelog history Every notable change, by version, drawn from the real git history — not backfilled from memory.
• Build History history The condensed narrative of how this was built — what failed, what got fixed, and what's known-fragile. The expanded version lives in the repo's iterations/ directory.