Installation and runtime

Install the local package, choose ESM or CommonJS loading and add optional rendering peers only when needed.

Use Node.js >=24.18.0 and Effect 4.0.3. The SDK is currently distributed from a local checkout. Follow the quickstart to build a tarball and install it into your application.

Choose an entrypoint

Import Email and common message types from @corven/email-sdk. Import provider Layers from their explicit subpaths, such as @corven/email-sdk/resend. Optional rendering, agent and webhook integrations have their own entrypoints; package reference lists their purposes.

The package is ESM. On supported Node versions, synchronous CommonJS consumers can load the same ESM graph. There is no separate CommonJS build and no compatibility guarantee for older Node, browsers, Bun or edge runtimes. In particular, an HTTP provider name does not prove that the whole package can run in a Worker.

Add React rendering

Core sending does not require React. For @corven/email-sdk/react, install the matching optional peers:

pnpm add react@19.3.1 react-dom@19.3.1 @react-email/render@2.1.0

TypeScript applications using React also need compatible React declarations. See React rendering.

Keep the package boundary intact

Use exported subpaths rather than importing internal dist/ files. Installed declarations describe the exact Effect errors and service requirements. Keep those requirements visible until your application provides the corresponding Layers.