Mailcraft

Mailcraft is a sender-agnostic SDK that turns intent into polished, on-brand transactional emails.

Monorepo Packages

  • @mailcraft/types: shared SDK contracts
  • @mailcraft/core: brand engine, archetypes, and rendering primitives
  • @mailcraft/theme-pack: open-source Step Zero archetype React Email pack
  • @mailcraft/adapter-resend: Resend sender adapter
  • @mailcraft/adapter-ses: AWS SES sender adapter
  • @mailcraft/sdk: public send/render API
  • @mailcraft/preview: local preview server

Step Zero Validation

  • Checklist: docs/validation/acceptance-checklist.md
  • Scorecard: docs/validation/step-zero-scorecard.md

Quick Start

  1. Install dependencies:
npm install
  1. Build all packages:
npm run build
  1. Run preview server:
npm run dev:preview
  1. Open the web docs:
pnpm run dev:docs

Then visit http://localhost:4040/docs.

Deploy Docs To Cloudflare Pages

  1. Authenticate once:
pnpm dlx wrangler login
  1. Build static docs:
pnpm run build:docs:cloudflare
  1. Deploy to Cloudflare Pages:
pnpm run deploy:docs:cloudflare

By default this deploys to the Cloudflare Pages project mailcraft-docs. Override the project name when needed:

CLOUDFLARE_PAGES_PROJECT=my-docs-project pnpm run deploy:docs:cloudflare