sofn-xyz/mailing

Mailing is an open-source toolkit for building and testing email templates using React. It targets JavaScript and TypeScript developers who want to write their email designs with the same component model they use for building web pages. The core idea is that you write email templates as React components, using MJML under the hood to ensure the output renders consistently across email clients, including Microsoft Outlook. Because email clients have notoriously inconsistent HTML rendering, MJML handles the cross-client compatibility layer, while you focus on writing familiar JSX. The toolkit ships with a preview server that reloads as you edit, so you can see exactly how an email looks before it goes out. In development mode, clicking send opens the email in your browser instead of actually delivering it, so there is no risk of accidentally sending test messages to real addresses. A test mode lets you verify that emails trigger correctly and carry the right content, which fits naturally into a CI pipeline. Mailing integrates with popular Node.js frameworks: Next.js, Redwood.js, and Remix all work without extra configuration. The library is written in TypeScript, and its design philosophy borrows from Action Mailer, the Ruby on Rails email library, bringing a similar structured approach to the JavaScript ecosystem. Setup is straightforward for any project already using React: install the npm package, create a templates directory, and point the CLI at it. The preview server starts with a single command. For teams that send transactional emails such as password resets, receipts, and notifications, Mailing offers a way to keep email templates in the same codebase as the rest of the app, under version control and testable like any other code.