JavaScript SDKs

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.

Open the Player SDK →

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.

Open the Headless SDK →

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 |