Inbaux

Programmable inbox infrastructure.

Requirements

• Docker + Docker Compose

That's it.

Local Development

# 1. Clone the repo
git clone https://github.com/dd3vahmad/inbaux.git
cd inbaux

# 2. Set up env
cp .env.example .env

# 3. Start everything
docker compose up --build

Services:

Service	Local URL
API	http://localhost
Postgres	localhost:5432
Redis	localhost:6379

Architecture

Inbound Email
     ↓
Email Ingestion Layer
     ↓
Redis Queue (Asynq)
     ↓
Worker (Parse + Extract)
     ↓
PostgreSQL
     ↓
API → Webhooks / SSE

Project Structure

/cmd
  /api        → API entrypoint
  /worker     → Worker entrypoint
/internal
  /api
    /handlers       → HTTP handlers
    /services       → Business logic
    /repositories   → DB access
  /db
    /queries        → sqlc SQL queries
  /workers          → Asynq job handlers
  /events           → Event definitions
  /webhooks         → Webhook dispatcher
  /realtime         → SSE streaming
  /config           → Env config
  /middleware       → Auth, rate limiting
/pkg                → Shared utilities
/docker             → Dockerfiles + Caddy config

Stack

• Language: Go
• Framework: Fiber
• Database: PostgreSQL (sqlc)
• Queue: Asynq + Redis
• Realtime: SSE
• Proxy: Caddy
• Deployment: Docker Compose