Skip to content

About

Work-in-progress repository for code to be used when demoing Hookdeck

Resources

Code of conduct

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Hookdeck Demos

Demo code for Hookdeck, organized by vendor and use case.

Directory Structure

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

Get one demo

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.

Demos

Hookdeck

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

Trigger.dev

Demo Description
github-ai-agent GitHub webhooks → Hookdeck → Trigger.dev: Claude PR reviews, issue labels, push summaries (task router vs Hookdeck routing)

Stripe

Demo Description
fetch-before-process Express.js app demonstrating the fetch-before-process webhook pattern

Shopify

Demo Description
webhooks-at-scale Complete Shopify app demo: setup, backpressure handling, and retry workflows

Deepgram

Demo Description
stt-tts Deepgram callbacks through Hookdeck: speech-to-text as JSON, and text-to-speech as binary audio/mpeg

Vapi

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

ElevenLabs

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

Retell AI

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

LiveKit

Demo Description
voice-adventure A multiplayer LiveKit voice adventure with AI characters; room, participant and ingress webhooks through Hookdeck build a session chronicle

Shared Utilities

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

Shared code

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.

Contributing

Each demo has its own README with setup instructions. See the individual demo directories for details.

About

Work-in-progress repository for code to be used when demoing Hookdeck

Resources

Code of conduct

Stars

1 star

Watchers

0 watching

Forks

Used by

Contributors

Languages