MeshHook — Mesh your webhooks. Orchestrate everything.

MeshHook is an MIT-licensed, webhook-first workflow engine with a visual builder (SvelteKit/Svelte 5) and Temporal-like durability via event sourcing on Postgres (Supabase).

Stack

• UI/API: SvelteKit (Svelte 5)
• DB/Queues/Realtime/Storage: Supabase (Postgres, Realtime, Storage)
• Workers: Node.js (or Bun), stateless
• Queue: pg-boss or pgmq (Postgres-native)
• Transforms: JMESPath ## Why MeshHook?

MeshHook's Sweet Spot

• Webhook-first: Built specifically for webhook orchestration and transformation
• Simple deployment: Single service on one port, no complex infrastructure
• MIT licensed: Truly open source, use anywhere without restrictions
• Event sourcing: Temporal-like durability without the complexity
• Visual + Code: Low-code visual builder with JMESPath for power users
• Postgres-native: Leverage Supabase for database, queues, realtime, and storage

Quick Start

Local Development

1. Install dependencies

   pnpm install
   

2. Setup environment (interactive)

   pnpm run setup
   

   Select "Local Development" when prompted. This creates .env.local with Supabase local defaults.

3. Start Supabase locally

   pnpx supabase start
   

4. Run migrations

   pnpm run db:migrate
   

5. Start the orchestrator

   pnpm run start
   

   Runs on port 8080 (configurable via PORT environment variable)

Production / Staging

1. Install dependencies

   pnpm install
   

2. Setup environment (interactive)

   pnpm run setup
   

   Select "Production" or "Staging" and enter your Supabase credentials.

3. Run migrations

   pnpm run db:migrate
   

   Automatically detects environment and pushes migrations to remote database.

4. Start the server

   pnpm run start
   

   Runs on port 8080 by default. Configure your reverse proxy to forward traffic to this port.

Available Commands

• pnpm run setup - Interactive environment configuration (local/staging/production)
• pnpm run db:migrate - Run database migrations (auto-detects environment)
• pnpm run start - Start the orchestrator worker (production)
• pnpm mh --help - CLI help

Environment Files

• .env.local - Local development (committed to repo with safe defaults)
• .env.staging - Staging environment (not committed)
• .env.production - Production environment (not committed)
• .env - Symlink to active environment (created by setup script)

Documentation

• ./docs/Environment-Setup.md - Detailed environment setup guide
• ./docs/Event-Partitioning.md - Event partitioning strategy and maintenance
• ./docs/PRD.md - Product requirements
• ./docs/Architecture.md - System architecture
• ./docs/diagrams/*.puml - PlantUML diagrams

Architecture

MeshHook runs as a single service on port 8080 that handles:

• Webhook intake and processing
• Workflow orchestration
• Background job execution
• HTTP request execution with retries

All components communicate via Supabase (Postgres) - no inter-service HTTP calls needed.

Built With

• node.js
• supabase
• svelte