monasher/chapar repository overview

⁠Chapar — Notification Gateway

Chapar (Persian: چاپار, courier) is an open-source, multi-channel notification gateway. Your services call one API; Chapar handles templating, queuing, retries, provider dispatch (SMS / Email / Push) and a full audit trail.

• Channels: SMS (KavehNegar), Email (SMTP), Push (Firebase FCM or Redis Pub/Sub in-app)
• Reliable: BullMQ + Redis queue, exponential backoff, per-attempt audit log in PostgreSQL
• Templated: Handlebars templates — send { template, data }, not raw strings
• Observable: Prometheus /metrics, health probes, structured logs
• Secure: API-key auth, rate limiting, Helmet, strict input validation
• Extensible: add a provider by implementing one interface (Strategy pattern)

⁠Quick start

docker run -d -p 3000:3000 --env-file .env <user>/chapar:latest

The same image runs as API, worker, or both via CHAPAR_ROLE=api|worker|all. See the compose file in the GitHub repo for the full stack (Postgres + Redis + API + workers).

⁠Tags

• latest — latest build from main
• X.Y.Z / X.Y — releases
• sha-<commit> — immutable builds

⁠Links

• Source & docs: https://github.com/mohammadnasher/chapar⁠
• License: MIT