🎣 Catchook

The most powerful webhook platform for developers
Capture, debug, transform, and route webhooks with zero configuration.

Warning

Catchook is under active development. APIs may change. Not recommended for production use yet.

---

✨ Why Catchook?

Stop fighting with webhooks. Catchook gives you superpowers:

• 🚀 Zero Config - Start capturing webhooks instantly
• 🔍 Smart Debugging - Real-time inspection with advanced filtering
• 🔄 Intelligent Routing - Route webhooks based on content, headers, or custom rules
• 📊 Live Monitoring - Beautiful dashboard with metrics and alerting
• 🛠️ Transform & Replay - Modify payloads and replay events
• ⚡ High Performance - Built with Go + Fiber for maximum throughput

🚀 Quick Start

Get Catchook running locally in under 2 minutes:

Prerequisites

• Go 1.24+
• Node.js 18+
• Docker & Docker Compose

1. Clone & Setup

git clone https://github.com/theotruvelot/catchook.git
cd catchook

# Start PostgreSQL & Redis
docker-compose -f docker-compose.dev.yml up -d

# Install dependencies
go mod tidy
cd app && npm install && cd ..

2. Environment Setup

# Copy example environment
cp .env.example .env

# The default config works with docker-compose setup!
# Edit .env if you need custom database credentials

3. Start Development

# Terminal 1: Start the API
make dev-api

# Terminal 2: Start the Frontend
make dev-app

# 🎉 Open http://localhost:3000

Your first webhook endpoint is ready at http://localhost:8080/hooks/your-unique-id

🏗️ Architecture

Catchook is built for performance and developer experience:

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Next.js App   │───▶│    Go Fiber API  │───▶│   PostgreSQL    │
│   (Frontend)    │    │   (Backend)      │    │   (Storage)     │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌─────────────────┐
                       │     Redis       │
                       │(Cache & Pub/Sub)│
                       └─────────────────┘

🛠️ Tech Stack

Component	Technology	Why?
Backend	Go + Fiber	Blazing fast HTTP performance
Database	PostgreSQL + SQLC	Type-safe SQL with zero ORM overhead
Cache	Redis	Real-time features & smart caching
Frontend	Next.js + TypeScript	Modern React with full-stack capabilities
Styling	Tailwind CSS + Shadcn UI	Rapid UI development
Auth	JWT	Stateless auth with performance

📁 Project Structure

catchook/
├── app/                    # Next.js frontend application
├── cmd/api/               # API entry point
├── internal/              # Private Go packages
│   ├── app/               # HTTP handlers & dependency injection
│   ├── config/            # Configuration management
│   ├── domain/            # Business logic & interfaces
│   ├── middleware/        # HTTP middleware (auth, logging, etc.)
│   ├── repository/        # Data access layer (SQLC)
│   └── service/           # Business orchestration
├── pkg/                   # Public Go packages
│   ├── cache/             # Redis abstraction
│   ├── jwt/               # JWT token management
│   ├── logger/            # Structured logging
│   └── validator/         # Request validation
├── storage/postgres/      # Database schemas & queries
└── bruno/                 # API testing collection

🤝 Contributing

We ❤️ contributions! Catchook is designed to be contributor-friendly.

🎯 Good First Issues

Look for issues labeled good first issue:

• 🐛 Bug fixes
• 📝 Documentation improvements
• ✨ Small feature additions
• 🧪 Test coverage improvements

🔧 Development Workflow

1. Fork & Clone

   git clone https://github.com/YOUR_USERNAME/catchook.git

2. Create Feature Branch

   git checkout -b feature/amazing-feature

3. Make Changes & Test

   make test
   make lint

4. Submit PR

   • Write clear commit messages
   • Add tests for new features
   • Update documentation

🧪 Testing (WIP)

# Run all tests
make test

# Run with coverage
make test-coverage

# Test specific package
go test ./internal/service/...

📖 API Documentation (WIP)

Explore the API with our Bruno collection.

Manual Deployment

# Build API
make build-api

# Build Frontend
cd app && npm run build

# Run migrations
make migrate-up

🗺️ Roadmap

🎯 v1.0 Goals:

• Complete webhook capture & replay
• Advanced filtering & transformation
• Webhook routing rules
• Real-time dashboard
• API rate limiting

📄 License

Catchook is Apache 2.0 licensed.

🙏 Acknowledgments

Built with amazing open-source tools:

• Fiber - Express-inspired Go web framework
• SQLC - Type-safe SQL in Go
• Next.js - React production framework
• Tailwind CSS - Utility-first CSS
• Shadcn UI - React UI library

A big thank to OpenSourceTogether for the amazing support and resources.

---

⭐ Star this repo | 🐛 Report Bug | 💡 Request Feature

Made with ❤️ by @theotruvelot and contributors