Better Notify

End-to-end typed notification infrastructure for Node.js (ESM-only, Node >= 22). A single catalog type drives the typed sender and webhook router — analogous to tRPC, but for notifications.

When to use

When setting up typed notifications, adding email/SMS/push transports, defining notification catalogs, or answering questions about @betternotify/* packages.

Skills

• setup — Interactive setup wizard. Scans your project, asks what channels/transports you need, and scaffolds the catalog + client.
• best-practices — Quick reference for configuration, channel slots, subpath imports, middleware, hooks, and common gotchas.

Core Concepts

Catalog — Typed contract defining notification routes. Built with createNotify(), composed via .catalog(). Sub-catalogs flatten into dot-path IDs (transactional.welcome).

Client — Type-safe sender derived from a catalog. createClient() returns mail.<route>.send(input) and .render().