{"id":20132381,"url":"https://github.com/stephtr/react-email-sender-adapters","last_synced_at":"2026-02-21T22:02:41.386Z","repository":{"id":244453384,"uuid":"815287121","full_name":"stephtr/react-email-sender-adapters","owner":"stephtr","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-15T22:27:09.000Z","size":63,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-09T22:23:11.546Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stephtr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-14T19:12:25.000Z","updated_at":"2025-07-16T01:19:58.000Z","dependencies_parsed_at":"2025-04-15T23:54:04.941Z","dependency_job_id":null,"html_url":"https://github.com/stephtr/react-email-sender-adapters","commit_stats":null,"previous_names":["stephtr/react-email-sender-adapters"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stephtr/react-email-sender-adapters","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephtr%2Freact-email-sender-adapters","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephtr%2Freact-email-sender-adapters/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephtr%2Freact-email-sender-adapters/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephtr%2Freact-email-sender-adapters/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stephtr","download_url":"https://codeload.github.com/stephtr/react-email-sender-adapters/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephtr%2Freact-email-sender-adapters/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29694792,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T18:18:25.093Z","status":"ssl_error","status_checked_at":"2026-02-21T18:18:22.435Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T20:53:23.416Z","updated_at":"2026-02-21T22:02:41.377Z","avatar_url":"https://github.com/stephtr.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# react-email-sender-adapters\n\nA unified interface for sending react-email emails across multiple email services. This package supports sending emails through console.log (development environment), AWS SES, MailChannels, and Azure Communication Services.\n\n## Features\n\n- Full support for `react-email`\n- Support for multiple email providers:\n  - AWS SES (`@aws-sdk/client-ses` is a required peerDependency)\n  - MailChannels (including support for DKIM configuration)\n  - Azure Communication Services (`@azure/communication-email` is a required peerDependency)\n- Development mode logging\n\n## Installation\n\n```bash\nnpm install react-email-sender-adapters\n```\n\n### Azure Communication Services\n\nIf you want to use this package in combination with Azure Communication Services, you additionally have to install the peer dependency `@azure/communication-email`:\n\n```bash\nnpm install @azure/communication-email\n```\n\n## Quick Start\n\n### Sending Basic Emails\n\n```jsx\n// use this import for Mailchannels;\n// for Azure Communication Services, import from `react-email-sender-adapters/to-azure-communication`\nimport sendEmail from \"react-email-sender-adapters/to-mailchannels\";\nimport TestEmail from \"./TestEmail\";\n\ntry {\n  await sendEmail(\u003cTestEmail /\u003e, {\n    subject: \"Test email\",\n    from: { name: \"John Doe\", email: \"john@example.com\" },\n    to: { email: \"smith@example.com\" },\n  });\n} catch (e) {\n  console.error(`Error sending the mail: ${e.message}`);\n}\n```\n\nIn development mode, this will output the email in the console. In production, the email will be sent via your chosen provider. To also use the provider in dev mode, set `useConsoleLogInDevMode: false` when calling `sendEmail`. Alternatively, you can write the following:\n\n```js\nimport { defaultEmailOptions } from \"react-email-sender-adapters\";\ndefaultEmailOptions.useConsoleLogInDevMode = false;\n```\n\n## API Reference\n\n```ts\ntype DefaultEmailOptions = {\n  useConsoleLogInDevMode: boolean;\n};\n\ntype EmailOptions = Partial\u003cDefaultEmailOptions\u003e \u0026 {\n  subject: string;\n  from: MailContact;\n  to: MailContacts;\n  cc?: MailContacts;\n  bcc?: MailContacts;\n  replyTo?: MailContact;\n  attachments?: Array\u003cAttachment\u003e;\n};\n\ntype MailContact = string | { name?: string; email: string };\ntype MailContacts = MailContact | Array\u003cMailContact\u003e;\n\ntype Attachment = {\n  contentType: string;\n  filename: string;\n  content: Buffer | ArrayBuffer | string; // base64 encoded string\n};\n```\n\n### AWS SES\n\nFor sending mails with AWS SES, one needs to configure the following settings:\n\n```ts\ntype AWSEmailOptions = EmailOptions \u0026 {\n  region?: string; // alternatively, set the env variable `AWS_SES_REGION`\n  accessKeyId?: string; // alternatively, set `AWS_SES_ACCESS_KEY_ID`\n  secretAccessKey?: string; // alternatively, set `AWS_SES_SECRET_ACCESS_KEY`\n};\n```\n\n### Mailchannels\n\nMailChannels supports signing your emails using DKIM. You can either supply the DKIM domain, selector, and private key to your EmailOptions, or provide them as environment variables `DKIM_DOMAIN`, `DKIM_SELECTOR`, and `DKIM_PRIVATE_KEY`, which will be automatically picked up.\n\n```ts\ntype MailchannelsEmailOptions = EmailOptions \u0026 {\n  dkim?: {\n    domain: string;\n    selector: string;\n    privateKey: string;\n  };\n};\n```\n\n### Azure Communication Services\n\nTo communicate with Azure Communication Services, a connection string is required. This can be supplied either via the environment variable `AZURE_COMMUNICATION_CONNECTION_STRING` or via your EmailOptions.\n\n```ts\ntype AzureEmailOptions = EmailOptions \u0026 {\n  connectionString?: string;\n};\n```\n\n### Zeptomail\n\nFor Zeptomail, the `url` and `token` parameters are needed. You can also supply them via the environment variables `ZEPTOMAIL_URL` and `ZEPTOMAIL_TOKEN`.\n\n```ts\ntype ZeptomailEmailOptions = EmailOptions \u0026 {\n  url?: string;\n  token?: string;\n};\n```\n\nUse this package to easily send React-based emails through multiple providers with robust support for development and production environments.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephtr%2Freact-email-sender-adapters","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstephtr%2Freact-email-sender-adapters","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephtr%2Freact-email-sender-adapters/lists"}