Initial visionLabs Roku scaffold

README.md

@@ -0,0 +1,37 @@
+# visionLabs Roku
+
+visionLabs Roku is a private Roku app scaffold for viewing home security cameras on a TV.
+
+## Product direction
+
+- Brand family follows the user's existing `Labs` naming pattern.
+- V1 uses a static packaged camera configuration.
+- V2 adds in-app camera and layout editing.
+- V3 moves camera metadata and layout persistence to a backend service.
+
+## Technical direction
+
+- Roku SceneGraph app
+- Camera feeds delivered as HLS where possible
+- Static JSON config for the first prototype
+- Future backend for editing, persistence, and auth
+
+## Project layout
+
+- `manifest` - Roku channel metadata
+- `source/main.brs` - app entry point
+- `components/MainScene.xml` - initial SceneGraph UI
+- `components/MainScene.brs` - scene behavior
+- `config/cameras.json` - static sample camera config
+- `docs/ROADMAP.md` - delivery phases and constraints
+
+## Notes
+
+Roku is not a great target for raw RTSP feeds. The clean path is to expose camera streams as HLS, either directly from the NVR or through a relay/transcoder layer.
+
+## Next steps
+
+1. Replace sample camera URLs in `config/cameras.json`
+2. Load config into the UI
+3. Render a static multi-camera grid
+4. Add edit mode and persistence strategy