Tango VisionBuild modules for cognitive buildings

One SDK. A contract the platform enforces at build, publish, and run time. On-demand sandboxes so you never touch production.

Get started

Your first module

Spin up a sandbox

📦

One package

@tv/extension-sdk gives you the manifest schema, the PlatformContext types, React hooks, NestJS decorators, and a CLI validator. Install it, target it, ship.

🔒

A contract, not a guess

The platform validates your manifest in CI, checks it again at publish, and composes your module at runtime. Stability tiers tell you exactly what won't break.

🧪

Sandboxes on demand

Spin up an isolated tenant with its own database, a seeded building graph, and a full tv-api stack — in under a minute. Never develop against production.

🛰️

Federated at runtime

Your module loads into the Building OS shell via Module Federation. No shell rebuild, no redeploy of the host — register and it appears.

Install

bash

npm install @tv/extension-sdk

Add the private registry to your .npmrc:

@tv:registry=https://npm.k8s.tangovision.dev/

The 60-second mental model

A module is a vertical slice — its own frontend and (optionally) backend — that plugs into the Tango Vision platform. Every module:

Declares a manifest (module-manifest.json) the platform validates.
Reads platform state through a single injected PlatformContext — never raw tokens or URLs.
Optionally publishes/subscribes to events on the platform bus.
Reports liveness so the shell knows it's running.

You build against the SDK; the platform enforces the contract. When something doesn't work, the seven contracts make it unambiguous whose side the problem is on.

Where to go next

Getting started — the lay of the land
Your first module — hello-world in 30 minutes
On-demand sandboxes — your private dev tenant
Manifest reference — every field explained