Skip to main content

Roku

Hosanna ships Roku apps by transpiling TypeScript into BrightScript and SceneGraph components. The Roku target is the most mature device path and is the best reference target for packaging, source maps, device logs, and release automation.

Development Flow​

  1. Develop shared UI in Web for fast iteration.
  2. Run the [ROKU] launch target from VS Code.
  3. Compile with hsc using the Roku hsconfig file.
  4. Bundle and deploy to a Roku device through BrighterScript tooling.
  5. Validate focus, remote input, media playback, deep links, and app startup on device.

Runtime Notes​

  • Input flows through Roku key events into HsInputEvent, FocusManager.handleInputEvent(event), and focused view onInputEvent(event) handlers.
  • Native Roku services can be wrapped with typed SceneGraph interfaces or isolated in hs_native_roku snippets.
  • Source maps allow breakpoint debugging from TypeScript into generated BrightScript.
  • The MCP debugger and Hosanna DevTools can inspect app state, focus, logs, screenshots, and runtime trees.

Release Checklist​

  • Configure assets/meta/app.config.json.
  • Confirm package metadata and signing keys.
  • Run production compiler and package scripts.
  • Test on representative low-end and current Roku hardware.
  • Verify channel size, app launch, networking, video, focus, and store deep-link requirements.

See Building For Roku and Native Development Roku for the detailed device workflow.