Start with email, add SMS and push later — one sender shape, one error model, one retry path. Swap the transport; keep your call sites. Node, Bun, Deno, Workers.
Docs ·
Handbook ·
llms.txt ·
sently
Sent with sently.
", }); ``` Same shape for every channel — apps use **sently senders**, not vendor SDKs: | Channel | Sender | Example transport | | -------- | ------------------------------------ | ------------------------------------------------------ | | Email | `createMailer` / `createSMTPMailer` | `sently/transports/resend`, `sently/smtp` | | SMS | `createSmsSender` | `sently/transports/twilio-sms`, `unifonic`, `taqnyat-sms` | | WhatsApp | `createWhatsAppSender` | `sently/transports/whatsapp-cloud` | | Push | `createPushSender` | `sently/transports/webpush`, `fcm` | Full walkthrough: [Get started](https://sently.omqkhafi.dev/docs/get-started). ## Why sently? Teams usually start on one channel (often email), then add SMS and push. Each vendor SDK brings its own auth, retries, and error shapes. sently keeps **one sender shape**, **one `SentlyError` model**, and **one retry/fallback path** as you add channels. **Library, not platform.** sently is the channel-delivery layer. Preference centers, digests, workflow builders, and in-app inboxes — custom logic or tools like [Novu](https://novu.co), [Knock](https://knock.app), or [Courier](https://www.courier.com) — sit **on top of** sently, not instead of it. Compared with email-only stacks (e.g. Nodemailer) and a pile of vendor clients: | | Typical stack | sently | | ----------------- | ------------------------------------- | ------------------------------------------- | | As channels grow | New SDK per channel | Same sender factories | | Failures | Per-vendor exceptions | Stable `SentlyError` codes | | Reliability | Ad-hoc per client | `RetryTransport` + `FallbackTransport` | | Providers | Vendor clients in app code | Pluggable transports | | Runtimes | Often Node only | Node, Bun, Deno, CF Workers | | Edge / Workers | Fat SDKs hurt cold start | Tree-shakeable (~6.3 KB HTTP · ~14.9 KB SMTP) | | Module format | Often CJS | ESM only | | Dependencies | Varies | 0 runtime deps | More detail: [Compare](https://sently.omqkhafi.dev/docs/guides/compare) · [Stability](https://sently.omqkhafi.dev/docs/get-started/stability) · [Support matrix](https://sently.omqkhafi.dev/docs/get-started/support-matrix). ## Entrypoints | Import | Use when | | ---------------------- | --------------------------------------------- | | `sently/mailer` | HTTP / custom email transports (smallest) | | `sently/smtp` | SMTP host, pool, adapters, DKIM | | `sently/sms` | SMS | | `sently/whatsapp` | WhatsApp | | `sently/push` | Push (Web Push or FCM) | | `sently/channel-result` | Shared `{ messageId, provider, accepted }` | | `sently/transports/*` | One provider or decorator per subpath | | `sently/webhooks/*` | Email / SMS / WhatsApp delivery parsers | ## Documentation | Resource | Link | | ------------ | ------------------------------------------------------------ | | Docs site | [sently.omqkhafi.dev](https://sently.omqkhafi.dev) | | Handbook | [/docs](https://sently.omqkhafi.dev/docs) | | Get started | [/docs/get-started](https://sently.omqkhafi.dev/docs/get-started) | | Channels | [/docs/channels](https://sently.omqkhafi.dev/docs/channels) | | Transports | [/docs/transports](https://sently.omqkhafi.dev/docs/transports) | | Compare | [/docs/guides/compare](https://sently.omqkhafi.dev/docs/guides/compare) | | Agents index | [/llms.txt](https://sently.omqkhafi.dev/llms.txt) | | Changelog | [`CHANGELOG.md`](CHANGELOG.md) | | Security | [`SECURITY.md`](SECURITY.md) | | Agents | [`AGENTS.md`](AGENTS.md) | Local docs: `bun run site:dev`. Verify: `bun run verify`. Semver-stable channel contracts. Published on [npm](https://www.npmjs.com/package/sently) (provenance + Trusted Publishing) and [JSR](https://jsr.io/@omqkhafi/sently). MIT.