SDKs
JavaScript SDKs
Choose between the JavaScript Player SDK (drop-in UI) and the JavaScript Headless SDK (bring your own player and chat UI).
HotMic provides two JavaScript SDKs. Pick the one that matches how much UI you want from HotMic — both share the same authentication and stream model.
JavaScript Player SDK
The drop-in web integration. Lists streams, joins a stream using your user's JWT, and hands the user off to a HotMic-hosted player URL — no HLS plumbing required. Use this if you want the fastest path to live streams on the web.
JavaScript Headless SDK
@hotmic/sdk — pure TypeScript API client with no UI. Runs in Node 18+, modern browsers, and React Native. Gives you HotMicClient, a StreamSession that handles auth, the 3-second delta-poll loop, presence, chat, reactions, polls, and battle questions. You provide the player (<video> + hls.js or native HLS) and the chat UI.
Which should I pick?
| Player SDK | Headless SDK | |
|---|---|---|
| Ships a player | Yes (HotMic-hosted) | No — you bring <video> + hls.js |
| Ships UI | Yes (chat, polls, tipping) | No — pure API |
| Customizable look | Limited (themes only) | Full control |
| Anonymous viewers | Supported | Supported (default) |
| Best for | Quick web integration, embedded sites | Custom apps, React Native, server-side, white-label |