Webapps

TelemetryTV's Software Development Kit (SDK) empowers you to create custom Webapps with your own HTML, JavaScript, and CSS code. This feature provides the flexibility to deploy a wide range of content on your digital signage displays.

Once created, your Webapp can be saved in your TelemetryTV account for future use, with the ability to update custom fields quickly.

If you're a developer, you can refer to our technical documentation on using our SDK here.

📘

For all 3rd party sites and application integrations, we recommend using webapps or the website app.

WebApp Compatibility: Use Single Page Applications Only

TelemetryTV Webapps are designed for Single Page Applications (SPAs) — not Multi-Page Applications (MPAs). If you're building or uploading a custom Webapp, ensure it behaves like a SPA, where all navigation and logic occur dynamically within a single HTML page.

Why MPAs Don't Work

Multi-Page Applications cause unexpected behavior in the TelemetryTV environment. When a page navigation event occurs (e.g., navigating from /home to /settings), the new page load breaks the persistent connection between the Telemetry SDK and the player. As a result:

• The SDK may not initialize correctly after navigation.
• Communication with the player (e.g. hardware triggers, content switching) may fail silently.
• The app may look like it's working, but SDK features won't function — leading to confusing and hard-to-debug issues.

This has already caused real-world issues with apps that appeared functional but failed in production due to MPA navigation disrupting the SDK-player lifecycle.

What to Use Instead

Use a SPA framework like:

• React (with React Router in "browser history" or "hash" mode)
• Vue (with Vue Router)
• Angular (with proper SPA routing)
• Vanilla JavaScript SPA patterns

All routes should be handled on the client side without full page reloads. If you're unsure, test whether navigating within your app reloads the page — if it does, it's not compatible.