sently 0.10.0 → 1.0.0

package/site/content/docs/decorators/index.mdx

@@ -55,13 +55,14 @@ const sms = createSmsSender({
 
 ## Learn more
 
+- [Failover recipe](../guides/failover) — retry inside a provider, then fail over
 - [Transports](../transports)
 - [Hooks](../channels/hooks)
 
 ## Next
 
 <Cards>
+  <Card title="Failover guide" href="/docs/guides/failover" />
   <Card title="Retry" href="/docs/decorators/retry" />
   <Card title="Fallback" href="/docs/decorators/fallback" />
-  <Card title="Transports" href="/docs/transports" />
 </Cards>

package/site/content/docs/decorators/preview.mdx

@@ -6,29 +6,72 @@ source: "src/transports/preview.ts"
 ---
 
 Write email previews to disk instead of delivering them.
+Use this when you want a local `.eml` or HTML file for the welcome email without a mail server.
 
 <Callout title="The one rule">Preview is for development, not delivery.</Callout>
 
-## Configuration
-
-`outDir`, `open`, and `format` are optional; defaults are `./.emails`, false, and `eml`.
+## Quick start
 
-<Steps><Step title="Wrap an email transport">
+<Steps>
+  <Step title="Create the preview transport">
 
 ```ts
+import { createMailer } from "sently/mailer";
 import { PreviewTransport } from "sently/transports/preview";
 
 const transport = new PreviewTransport({ outDir: ".emails", open: true });
+const mailer = await createMailer({ transport });
 ```
 
-</Step><Step title="Create the mailer">
+  </Step>
+  <Step title="Send and open the file">
 
 ```ts
-const mailer = await createMailer({ transport });
+await mailer.send({
+  from: "dev@example.com",
+  to: "you@example.com",
+  subject: "Welcome",
+  text: "Thanks for joining.",
+});
 ```
 
-</Step></Steps>
+Files land under `outDir` (default `./.emails`). With `open: true`, the OS opens the written file.
+
+  </Step>
+</Steps>
+
+## Configuration
+
+| Option | Type | Default | Meaning |
+| --- | --- | --- | --- |
+| `outDir` | `string` | `"./.emails"` | Directory for preview files |
+| `open` | `boolean` | `false` | Open the file after write |
+| `format` | `"eml" \| "html"` | `"eml"` | Full MIME or HTML body only |
+
+`provider` is `"preview"`. `verify()` always succeeds.
+
+For a real SMTP catcher with a web UI, use [Mailpit](/docs/transports/mailpit) instead.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Does Preview wrap another transport?">
+    No. `PreviewTransport` is the delivery transport — it writes to disk and does not call a provider.
+  </Accordion>
+  <Accordion title="Where is the file?">
+    Check `outDir` (default `./.emails`). The console logs `[sently preview] Written: …` on each send.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Mailpit](/docs/transports/mailpit) — local SMTP catcher with inbox API
+- [Email channel](/docs/channels/email) — `createMailer` contract
 
-<Accordions><Accordion title="Does this replace the inner provider?">No. It delegates sends to the wrapped transport.</Accordion></Accordions>
+## Next
 
-<Cards><Card title="Email channel" href="/docs/channels/email" /></Cards>
+<Cards>
+  <Card title="Mailpit" href="/docs/transports/mailpit" />
+  <Card title="Email channel" href="/docs/channels/email" />
+  <Card title="Decorators" href="/docs/decorators" />
+</Cards>

package/site/content/docs/get-started/entrypoints.mdx

@@ -88,7 +88,7 @@ No. `createMailer` requires a transport. Import `createSMTPMailer` from `sently/
 
 <Accordion title="Where do provider transports come from?">
 
-Import the concrete transport from its exported `sently/transports/*` subpath, such as `sently/transports/sndr` or `sently/transports/resend`.
+Import the concrete transport from its exported `sently/transports/*` subpath, such as `sently/transports/sndr`, `sently/transports/resend`, or `sently/transports/mailpit`.
 
 </Accordion>
 
@@ -103,13 +103,15 @@ HTTP providers were removed from the main barrel so bare Node/Deno imports do no
 ## Learn more
 
 - [Export reference](/docs/reference/exports) — full entrypoint map
+- [Support matrix](/docs/get-started/support-matrix) — Supported vs Available
+- [Stability policy](/docs/get-started/stability) — frozen entrypoints at 1.x
 - [All transports](/docs/transports) — providers by channel
-- [Bundle size](/docs/guides/bundle-size) — keep stacks small
+- [Bundle size](/docs/guides/bundle-size) — keep stacks small on Workers
 
 ## Next
 
 <Cards>
   <Card title="Exports reference" description="Public package entrypoints." href="/docs/reference/exports" />
+  <Card title="Support matrix" description="Production support promise." href="/docs/get-started/support-matrix" />
   <Card title="Email channel" description="createMailer and MailOptions." href="/docs/channels/email" />
-  <Card title="SNDR" description="HTTP email via SNDR." href="/docs/transports/sndr" />
 </Cards>

package/site/content/docs/get-started/index.mdx

@@ -5,10 +5,16 @@ icon: FolderOpen
 source: "README.md"
 ---
 
-Install sently and send your first message.
+Install sently and send your first message. Learn the channel model once, then add SMS or push without a new failure model.
 
 <Cards>
   <Card title="Introduction" href="/docs/get-started/introduction" />
   <Card title="Installation" href="/docs/get-started/installation" />
-  <Card title="Quick start" href="/docs/quick-start" />
+  <Card title="Entrypoints" href="/docs/get-started/entrypoints" />
+  <Card title="Runtimes" href="/docs/get-started/runtimes" />
+  <Card title="Channels" href="/docs/channels" />
+  <Card title="Migrate from Nodemailer" href="/docs/get-started/migrate-nodemailer" />
+  <Card title="Stability policy" href="/docs/get-started/stability" />
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
+  <Card title="Non-goals" href="/docs/get-started/non-goals" />
 </Cards>

package/site/content/docs/get-started/introduction.mdx

@@ -5,8 +5,8 @@ icon: Compass
 source: "README.md"
 ---
 
-sently sends email, SMS, WhatsApp, and push (Web Push or FCM) without making provider SDK calls your application API.
-Choose the channel sender first, then attach the provider transport that performs delivery.
+sently is the channel-delivery layer for email, SMS, WhatsApp, and push (Web Push or FCM).
+Choose a channel sender first, then attach a provider transport — so adding SMS or push later does not invent a new error and retry model in your app.
 
 <Callout title="The one rule">Use `createMailer`, `createSmsSender`, `createWhatsAppSender`, or `createPushSender` in app code; swap transports when provider configuration changes.</Callout>
 
@@ -67,11 +67,15 @@ Email factories are asynchronous. The other channel factories return their sende
 
 - [Install sently](./installation)
 - [Choose an entrypoint](./entrypoints)
+- [Stability policy](./stability)
+- [Support matrix](./support-matrix)
+- [Compare](/docs/guides/compare)
 - [Explore channels](../channels)
 
 ## Next
 
 <Cards>
-  <Card title="Email quick start" href="/docs/quick-start/email" />
+  <Card title="Email channel" href="/docs/channels/email" />
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
   <Card title="Channels" href="/docs/channels" />
 </Cards>

package/site/content/docs/get-started/meta.json

@@ -7,6 +7,9 @@
     "installation",
     "entrypoints",
     "runtimes",
-    "migrate-nodemailer"
+    "migrate-nodemailer",
+    "stability",
+    "support-matrix",
+    "non-goals"
   ]
 }

package/site/content/docs/get-started/migrate-nodemailer.mdx

@@ -2,22 +2,149 @@
 title: Migrate from Nodemailer
 description: Move SMTP configuration and message fields to sently incrementally.
 icon: ArrowRightLeft
-source: "README.md"
+source: "src/smtp-mailer.ts"
 ---
 
-Keep your message object, replace transporter construction, and await the sently factory.
+Keep your welcome email, receipt, or password-reset fields (`from`, `to`, `subject`, `text` / `html`).
+Replace `createTransport` with `createSMTPMailer`, rename `sendMail` to `send`, and `await` the factory before the first send.
+
+<Callout title="The one rule">
+  Use `createSMTPMailer` for relay host/port/auth. Use `createMailer` only when you already have an explicit transport.
+</Callout>
+
+## Quick start
+
+<Steps>
+  <Step title="Create the mailer">
 
 ```ts
 import { createSMTPMailer } from "sently/smtp";
 
 const mailer = await createSMTPMailer({
   host: "smtp.example.com",
+  port: 587,
   auth: { user: "user@example.com", pass: process.env.SMTP_PASSWORD! },
 });
 ```
 
-<Callout title="The one rule">Use `createSMTPMailer` for relay configuration; use `createMailer` only with an explicit transport.</Callout>
+  </Step>
+  <Step title="Send with the same fields">
+
+```diff
+- const info = await transporter.sendMail({
++ const result = await mailer.send({
+    from: "Acme <hello@example.com>",
+    to: "person@example.com",
+    subject: "Welcome",
+    text: "Thanks for joining.",
+  });
+```
+
+  </Step>
+  <Step title="Read the result">
+
+```ts
+console.log(result.messageId, result.accepted, result.rejected);
+```
+
+  </Step>
+</Steps>
+
+## API map
+
+| Nodemailer | sently |
+| --- | --- |
+| `createTransport({ host, port, auth })` | `await createSMTPMailer({ host, port, auth })` |
+| `transporter.sendMail(msg)` | `mailer.send(msg)` |
+| `transporter.verify()` | `mailer.verify()` |
+| `transporter.close()` | `mailer.close()` |
+| `info.messageId` / `accepted` / `rejected` / `response` / `envelope` | Same fields on `SendResult` |
+| HTTP providers via plugins / custom | `createMailer` + `sently/transports/<provider>` |
+
+## Message fields
+
+| Nodemailer | sently |
+| --- | --- |
+| `from` / `to` / `cc` / `bcc` / `replyTo` | Same names on `MailOptions` |
+| `subject`, `text`, `html`, `headers`, `messageId`, `date` | Same names |
+| `priority` | `"high" \| "normal" \| "low"` |
+| `attachments[].filename` / `content` / `path` / `contentType` | Same names |
+| `attachments[].cid` | `attachments[].contentId` |
+| `attachments[].contentDisposition: "inline"` | `attachments[].inline: true` |
+| `icalEvent`, SOCKS proxy options | Not supported — see [Non-goals](/docs/get-started/non-goals) |
+
+## SMTP options
+
+| Option | Type | Default | Meaning |
+| --- | --- | --- | --- |
+| `host` | `string` | required | Relay hostname |
+| `port` | `number` | `587` (`465` if `secure`) | SMTP port |
+| `secure` | `boolean` | `false` | Implicit TLS on connect |
+| `auth` | `SMTPAuth` | — | `{ user, pass?, type?, oauth2? }` |
+| `pool` | `boolean` | `false` | Connection pooling |
+| `requireTLS` | `boolean` | `true` when `auth` is set | Refuse AUTH on a cleartext connection |
+| `tls` | `TLSOptions` | — | `rejectUnauthorized`, `servername`, `minVersion` |
+| `connectionTimeout` | `number` | — | Socket connect timeout (ms) |
+| `greetingTimeout` | `number` | — | Wait for SMTP greeting (ms) |
+| `socketTimeout` | `number` | — | Idle socket timeout (ms) |
+
+## Switch to an HTTP provider later
+
+Keep `mailer.send` and change only construction:
+
+```diff
+- import { createSMTPMailer } from "sently/smtp";
+- const mailer = await createSMTPMailer({ host, port, auth });
++ import { createMailer } from "sently/mailer";
++ import { ResendTransport } from "sently/transports/resend";
++ const mailer = await createMailer({
++   transport: new ResendTransport({ apiKey: process.env.RESEND_API_KEY! }),
++ });
+```
+
+**Consequence:** message fields stay the same; only the factory and transport change.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title='Error: "SMTP config passed to transport-only createMailer"'>
+    `createMailer` accepts only `{ transport, plugins?, hooks? }`. Move host/port/auth to `createSMTPMailer` from `sently/smtp`.
+  </Accordion>
+  <Accordion title="Do I need to rewrite every message object?">
+    Usually no. Keep `from`, `to`, `subject`, and body fields; change construction and `sendMail` → `send`. Rename attachment `cid` to `contentId` when you use inline images.
+  </Accordion>
+  <Accordion title="Why is createSMTPMailer async?">
+    The factory prepares the runtime SMTP connection path (and optionally the pool) before returning. Always `await` it before `send`.
+  </Accordion>
+  <Accordion title="Is sently a drop-in for every Nodemailer plugin?">
+    No. SOCKS and iCal are intentional non-goals. See [Non-goals](/docs/get-started/non-goals) and [Compare](/docs/guides/compare).
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Email channel](/docs/channels/email) — mailer + transport model after you migrate
+- [Mail options](/docs/reference/mail-options) — full `MailOptions` field list
+- [Attachments](/docs/guides/attachments) — `content`, `path`, and `contentId`
+- [Entrypoints](/docs/get-started/entrypoints) — `sently/smtp` vs `sently/mailer`
+- [Support matrix](/docs/get-started/support-matrix) — which runtimes and exports are supported
 
-<Accordions><Accordion title="Why does transport-only createMailer reject host?">It only accepts a `transport`. Move relay configuration to `createSMTPMailer`.</Accordion></Accordions>
+## Next
 
-<Cards><Card title="Email channel" href="/docs/channels/email" /></Cards>
+<Cards>
+  <Card
+    title="Email channel"
+    description="Send with createMailer or createSMTPMailer."
+    href="/docs/channels/email"
+  />
+  <Card
+    title="SMTP transport"
+    description="Relay options when you wire SMTPTransport yourself."
+    href="/docs/transports/smtp"
+  />
+  <Card
+    title="Compare"
+    description="Nodemailer, vendor SDKs, and orchestration platforms."
+    href="/docs/guides/compare"
+  />
+</Cards>

package/site/content/docs/get-started/non-goals.mdx

@@ -0,0 +1,57 @@
+---
+title: Non-goals
+description: What sently intentionally does not ship — and what belongs on top.
+icon: Ban
+source: "README.md"
+---
+
+sently is a **channel-delivery library**. Keeping the surface focused is part of the 1.x promise.
+
+<Callout title="The one rule">
+  Do not expect dashboards, preference centers, digests, or workflow builders inside sently. Put that product logic — or Novu / Knock / Courier — on top of the delivery layer.
+</Callout>
+
+## Out of scope
+
+| Non-goal | Notes |
+| --- | --- |
+| Orchestration platforms | Preference centers, digests, journey builders, in-app inboxes |
+| Hosted SaaS / per-send billing | MIT library in your process |
+| APNs as a native push transport | Use FCM and/or Web Push for 1.x |
+| Voice channels | Not a sently channel |
+| Inbound email productization | Outbound + webhook parsers only |
+| Nodemailer SOCKS / iCal parity | Intentionally omitted |
+| Equal support for every export | See [Support matrix](./support-matrix) |
+| Cross-channel preview / idempotency | Email-only today |
+
+## Complementary stack
+
+| Need | Place it… |
+| --- | --- |
+| Send email / SMS / WhatsApp / push | sently channel senders |
+| Swap providers without rewriting call sites | sently transports |
+| Preferences, digests, workflows, in-app | Your app or Novu / Knock / Courier **on top of** sently |
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Will sently add a preference center?">
+    No. That is platform territory and conflicts with the library-not-platform position.
+  </Accordion>
+  <Accordion title="Where should I read the positioning story?">
+    See [Compare](/docs/guides/compare).
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Compare](/docs/guides/compare)
+- [Support matrix](./support-matrix)
+- [Stability policy](./stability)
+
+## Next
+
+<Cards>
+  <Card title="Compare" href="/docs/guides/compare" />
+  <Card title="Introduction" href="/docs/get-started/introduction" />
+</Cards>

package/site/content/docs/get-started/stability.mdx

@@ -0,0 +1,69 @@
+---
+title: Stability policy
+description: What is frozen at 1.0 and what may grow under semver.
+icon: Shield
+source: "package.json"
+---
+
+From **1.0.0**, sently follows semver for the public channel-delivery surface.
+Apps should depend on channel senders and contracts — not on vendor SDK shapes.
+
+<Callout title="The one rule">
+  Treat channel factories, transport contracts, hooks, `SentlyError` codes, and
+  published subpath entrypoints as stable. New transports and optional fields may
+  appear in minor releases; renames or narrowed types require a major.
+</Callout>
+
+## Frozen at 1.x (Tier A)
+
+| Surface | Stable APIs |
+| --- | --- |
+| Factories | `createMailer`, `createSMTPMailer`, `createSmsSender`, `createWhatsAppSender`, `createPushSender` |
+| Contracts | `Transport`, `SmsTransport`, `WhatsAppTransport`, `PushTransport` option and result shapes |
+| Shared | Lifecycle hooks, `SentlyError` / `sentlyCode`, `ChannelSendResult` / `toChannelSendResult` |
+| Decorators | `RetryTransport`, `FallbackTransport` on all channels |
+| Email-only decorators | `IdempotencyTransport`, `PreviewTransport` (documented as email-only; not removed) |
+| Entrypoints | Subpaths listed in `package.json` `exports` — no silent moves |
+
+## Intentional shapes (stable, not transitional)
+
+| Shape | Meaning |
+| --- | --- |
+| `PushOptions` | Discriminated union: Web Push `subscription` **or** FCM `token` |
+| `providerIndex` | Optional on send results when a fallback decorator handled the send |
+| Email-only preview / idempotency | Stay email-scoped; not a signal they will move to other channels soon |
+
+## Allowed without a major
+
+- New transport classes and webhook parsers
+- New optional fields on options/results
+- New subpath exports
+- Bug fixes and security patches on the current **1.x** line
+
+## Security patches
+
+See [`SECURITY.md`](https://github.com/alialnaghmoush/sently/blob/main/SECURITY.md) for reporting and which versions receive patches.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Can I pin 0.x in production after 1.0?">
+    Prefer upgrading to 1.x. Pre-1.0 may still receive best-effort fixes but is not the supported security line.
+  </Accordion>
+  <Accordion title="Where is the production support promise?">
+    See [Support matrix](./support-matrix) for Supported vs Available transports.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Support matrix](./support-matrix)
+- [Non-goals](./non-goals)
+- [Compare](/docs/guides/compare)
+
+## Next
+
+<Cards>
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
+  <Card title="Non-goals" href="/docs/get-started/non-goals" />
+</Cards>

package/site/content/docs/get-started/support-matrix.mdx

@@ -0,0 +1,62 @@
+---
+title: Support matrix
+description: Supported vs Available transports and runtimes for production use.
+icon: LayoutGrid
+source: "package.json"
+---
+
+Not every exported transport is part of the **1.x production promise**.
+**Supported** paths are documented, tested, and operable (verify, retry/fallback, and webhooks where listed).
+**Available** paths ship and have unit coverage but are not the support bar.
+
+<Callout title="The one rule">
+  Build production apps on Supported transports. Treat Available exports as optional extras you can adopt knowing the promise is thinner.
+</Callout>
+
+## Supported (v1 promise)
+
+| Channel | Supported transports | Operability |
+| --- | --- | --- |
+| Email | SMTP, Resend, SES, SendGrid, Postmark | Attachments / HTML / text, `verify`, retry / fallback, webhooks for the HTTP majors |
+| SMS | Twilio SMS, Unifonic | Webhooks for Twilio and Unifonic |
+| WhatsApp | WhatsApp Cloud | Signature verify + delivery parse |
+| Push | Web Push, FCM | Option union: `subscription` (Web Push) or `token` (FCM) |
+| Runtimes | Node ≥18, Bun, Deno, Cloudflare Workers | Adapters and smoke scripts |
+
+FCM uses the current Firebase HTTP API (service-account JWT, no Google SDK). That is baseline push support, not a special feature tier.
+
+## Available (exported, not the v1 bar)
+
+| Channel | Available examples |
+| --- | --- |
+| Email | Mailgun, Brevo, MailerSend, Plunk, SparkPost, Mailtrap, Mailpit (dev), Loops, SNDR, Taqnyat Mail, Cloudflare Email, … |
+| SMS | Taqnyat SMS, Msegat |
+| WhatsApp | Taqnyat WhatsApp |
+| Decorators | `WeightedFallbackTransport` (advanced); preview / idempotency remain email-only |
+| Local email | [Mailpit](/docs/transports/mailpit) (SMTP catcher), [Preview](/docs/decorators/preview) (disk) |
+
+Available transports stay in the package. They are promoted to Supported when docs, operability, and smoke coverage meet the bar above.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Can I use an Available transport in production?">
+    Yes, at your own risk. Prefer Supported paths when you need the documented operability promise.
+  </Accordion>
+  <Accordion title="Why is Mailgun Available but Postmark Supported?">
+    The Supported set is a deliberate short list for the 1.x promise — not a popularity ranking of every working export.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Stability policy](./stability)
+- [Non-goals](./non-goals)
+- [Transports](/docs/transports)
+
+## Next
+
+<Cards>
+  <Card title="Stability policy" href="/docs/get-started/stability" />
+  <Card title="Transports" href="/docs/transports" />
+</Cards>

package/site/content/docs/guides/compare.mdx

@@ -0,0 +1,87 @@
+---
+title: Compare
+description: How sently fits next to vendor SDKs, Nodemailer, and orchestration platforms.
+icon: Scale
+source: "README.md"
+---
+
+Teams often start with one channel — usually email via SendGrid or Resend — then add SMS and push.
+Each new vendor SDK brings its own auth, retries, and error shapes into app code.
+
+<Callout title="The one rule">
+  Treat sently as the channel-delivery layer. Put preference centers, digests, workflow builders, and in-app inboxes on top of it — custom code or a tool like Novu, Knock, or Courier — not instead of it.
+</Callout>
+
+## What sently replaces
+
+| Instead of… | Use sently for… |
+| --- | --- |
+| A growing pile of vendor SDKs in call sites | Channel senders + pluggable transports |
+| Per-channel retry and error glue | Shared `SentlyError` codes and retry/fallback decorators |
+| Nodemailer when you need multi-channel or non-Node runtimes | `createMailer` / `createSMTPMailer` plus SMS, WhatsApp, and push |
+
+## What sently does not replace
+
+| Need | Where it lives |
+| --- | --- |
+| Preference centers and unsubscribe UX | Your product, or Novu / Knock / Courier |
+| Digest / batching product logic | Your product, or an orchestration platform |
+| Workflow builders and multi-step journeys | Your product, or Novu / Knock / Courier |
+| In-app notification inboxes | Your product, or an orchestration platform |
+
+Those tools (or your own routing) call sently — or any transport — to deliver. sently does not ship dashboards or per-send SaaS.
+
+## Versus a vendor SDK pile
+
+| Concern | Typical stack | sently |
+| --- | --- | --- |
+| As you add channels | New SDK, new auth, new retries | Same sender factories |
+| Failures | Per-vendor exceptions | Stable `SentlyError` codes |
+| Reliability | Ad-hoc loops per client | `RetryTransport` + `FallbackTransport` |
+| Provider swap | Rewrite call sites | Swap the transport |
+
+## Versus Nodemailer
+
+| Concern | Nodemailer | sently |
+| --- | --- | --- |
+| Channels | Email | Email · SMS · WhatsApp · Push |
+| Runtimes | Node.js | Node · Bun · Deno · CF Workers |
+| Module format | CommonJS | ESM only |
+| Edge / Workers weight | Full mail stack on import | Tree-shakeable subpaths (~6.3 KB HTTP) |
+
+Bundle size matters most on Workers and cold starts. It is supporting evidence, not the primary reason to adopt.
+
+## Versus Novu, Knock, and Courier
+
+| Concern | Orchestration platforms | sently |
+| --- | --- | --- |
+| Role | Workflows, preferences, digests, in-app | Channel delivery / transports |
+| Hosting | Usually hosted SaaS | Library in your process |
+| Pricing model | Often per-send or seat | MIT package; you pay providers |
+
+Use both when you need product orchestration **and** a typed, multi-runtime delivery layer underneath.
+
+## Troubleshooting
+
+<Accordions>
+  <Accordion title="Do I need sently if I already use Novu or Knock?">
+    Only if you want local, typed transports under your own routing — or to send outside that platform. Many teams use an orchestration tool for preferences and journeys, and a library like sently for direct transactional sends.
+  </Accordion>
+  <Accordion title="Is sently a Nodemailer drop-in?">
+    No. Migrate email with [Migrate from Nodemailer](/docs/get-started/migrate-nodemailer), then add other channels with the same sender pattern.
+  </Accordion>
+</Accordions>
+
+## Learn more
+
+- [Introduction](/docs/get-started/introduction)
+- [Stability policy](/docs/get-started/stability)
+- [Support matrix](/docs/get-started/support-matrix)
+- [Migrate from Nodemailer](/docs/get-started/migrate-nodemailer)
+
+## Next
+
+<Cards>
+  <Card title="Introduction" href="/docs/get-started/introduction" />
+  <Card title="Support matrix" href="/docs/get-started/support-matrix" />
+</Cards>