Demo code for Hookdeck, organized by vendor and use case.
Demos follow a vendor/use-case/ convention. Hookdeck itself is treated as a vendor for feature demos.
hookdeck/ Hookdeck feature demos
trigger-dev/ Trigger.dev integration demos
stripe/ Stripe integration demos
shopify/ Shopify integration demos
deepgram/ Deepgram integration demos
vapi/ Vapi integration demos
elevenlabs/ ElevenLabs integration demos
retell/ Retell AI integration demos
livekit/ LiveKit integration demos
_shared/ Source of truth for code shared across demos
Each demo is standalone. You do not need to clone this repo.
npx giget@latest gh:hookdeck/hookdeck-demos/<vendor>/<demo> my-demo
cd my-demo && npm install
For example, npx giget@latest gh:hookdeck/hookdeck-demos/deepgram/stt-tts my-demo. Prefer git? Clone the repo and cd <vendor>/<demo>. Each demo's README has its setup steps.
| Demo |
Description |
| binary-payloads |
Send audio, video, images, archives, PDFs and binary serialization formats through a source to hookdeck listen, and check which content types arrive byte-exact |
| cli-fleet-fanout |
Fan out webhooks to a fleet of machines on a private network with CLI destinations: connection-per-machine vs connection-per-group |
| cli-overview |
Overview of the Hookdeck CLI capabilities |
| deduplication |
Event deduplication with payload-based and ID-based modes |
| demo-scripts |
Scripts for automating demo setup and event triggering |
| general |
Next.js app for receiving and verifying webhooks from multiple providers |
| mcp-events-forward-proxy |
Receive MCP Events through Event Gateway acting as the agent's forward proxy: challenge, verification, dedup and retries, locally with hookdeck listen or deployed over HTTP |
| mcp-events-outpost |
Send MCP Events from an MCP server with Hookdeck Outpost's native MCP Events support, which runs the subscriptions and delivers each event (links to hookdeck/mcp-events-outpost-demo) |
| session-filters |
CLI session filters demo |
| transformations |
Transformations that import Node.js built-ins (node:zlib, node:crypto, node:buffer) to turn JSON events into a PNG, WAV, PDF or SVG, sign requests, and decompress binary payloads, with a UI that follows each event from source to result |
| transformation-reordering |
Transformation and filter rule reordering |
| Demo |
Description |
| github-ai-agent |
GitHub webhooks → Hookdeck → Trigger.dev: Claude PR reviews, issue labels, push summaries (task router vs Hookdeck routing) |
| Demo |
Description |
| fetch-before-process |
Express.js app demonstrating the fetch-before-process webhook pattern |
| Demo |
Description |
| webhooks-at-scale |
Complete Shopify app demo: setup, backpressure handling, and retry workflows |
| Demo |
Description |
| stt-tts |
Deepgram callbacks through Hookdeck: speech-to-text as JSON, and text-to-speech as binary audio/mpeg |
| Demo |
Description |
| agency-routing |
A voice AI agency routes each client's Vapi call events to that client's endpoint, with an async tool that returns its result into the live call |
| Demo |
Description |
| post-call-transcripts |
ElevenLabs Agents post-call webhooks through Hookdeck: signature verification, deduplication on conversation_id, retries and replay, and large transcript and audio payloads, stored and shown in a small app |
| Demo |
Description |
| outbound-lead-calling |
A lead arrives, Retell places an outbound call, and the call_started, call_ended and call_analyzed events come back through Hookdeck (signature verification, deduplication, retries) to update the lead |
| Demo |
Description |
| voice-adventure |
A multiplayer LiveKit voice adventure with AI characters; room, participant and ingress webhooks through Hookdeck build a session chronicle |
| Utility |
Description |
| ds |
Hookdeck design system: tokens, styles and brand assets (copied into demos, see Shared code) |
| flow-drawer |
Bottom drawer that shows each message moving through Event Gateway to the app, live (client JS and CSS, plus a server module that reads the Hookdeck API) |
| hookdeck |
Hookdeck CLI helper and hookdeck listen wrapper (TypeScript) |
| scenes |
Scene kit: animated topology diagrams for a demo's live view, hookdeck.com guides and MP4 captures (TypeScript, SVG, GSAP) |
| theme |
Light/dark/system theme switch for the design system, with an optional demo theme and wording (theme.js) |
| tmux-presenter |
Tmux-based live demo presenter for running scripted terminal demos |
| topology-pane |
Bottom "Data flow" pane that shows the scene kit's live topology and scripted scenes |
Some code is the same in several demos: the Hookdeck design system (ds/), the Hookdeck CLI helpers (scripts/hookdeck-cli.ts, scripts/hookdeck-listen.ts), the data-flow drawer (flow-drawer/), the scene kit (scenes/), the topology pane (topology-pane/) and the theme switch (theme.js). So a demo still works when downloaded alone, each demo holds a real copy of what it uses. The source of truth is _shared/.
- Edit in
_shared/ only. Copies carry a "Generated from" header (directories also have a GENERATED.md), so an edit in the wrong place is easy to spot in review.
_shared/manifest.json lists which demo takes which piece and where it goes inside the demo. A demo not listed for a piece may own its own copy.
npm run sync-shared (from the repo root, Node 22) copies the pieces into the demos. npm run sync-shared -- --check changes nothing, prints the files that differ and exits non-zero if any do.
- CI (
.github/workflows/shared.yml) runs --check on every pull request and push to main. It also copies each demo in the manifest to an empty folder on its own, runs npm ci (or npm install) and the demo's typecheck script if it has one.
To add a demo to a piece, add it to demos in the manifest and run npm run sync-shared.
Each demo has its own README with setup instructions. See the individual demo directories for details.