Get Started.

1npm install guralnik-mailer

1yarn add guralnik-mailer

1pnpm add guralnik-mailer

1npx guralnik-mailer

1{
2  "provider": "resend",
3  "apiKey": "re_your_api_key_here",
4  "from": "Your Brand <hello@your-domain.com>",
5  "replyTo": "support@your-domain.com",
6  "theme": {
7    "designType": "midnight",
8    "colors": {
9      "primary": "#059669",
10      "background": "#111827",
11      "text": "#f9fafb",
12      "accent": "#34D399"
13    },
14    "logo": "https://your-domain.com/logo.png",
15    "brandName": "Your Brand"
16  },
17  "locale": "en",
18  "preview": {
19    "port": 3001
20  }
21}

1npm install guralnik-mailer

1import { SmartMedusaAdapter } from "guralnik-mailer";
2
3const adapter = new SmartMedusaAdapter();
4
5export default async function mailerSubscriber({
6  data,
7  eventName,
8}: any) {
9  await adapter.handleEvent(eventName, data);
10}
11
12export const config = {
13  event: SmartMedusaAdapter.getSupportedEvents(),
14  context: { subscriberId: "guralnik-mailer" },
15};

1npx guralnik-mailer

1import { mailer } from "guralnik-mailer";
2
3await mailer.send(
4  "OrderConfirmation",   // template name
5  "customer@example.com", // recipient
6  {
7    locale: "en",
8    name: "Jane Doe",
9    orderId: "ORD-12345",
10    items: [
11      {
12        title: "Ceramic Espresso Mug",
13        quantity: 2,
14        price: "45.00",
15        currency: "€",
16      },
17    ],
18  }
19);

1mailer.send(
2  templateName: string,   // name of the template (e.g. "Welcome")
3  to: string | string[],  // recipient email(s)
4  data: {
5    locale?: string;      // language code (default: config locale)
6    [key: string]: any;   // template-specific data
7  },
8  options?: {
9    from?: string;        // override sender
10    replyTo?: string;     // override reply-to
11    subject?: string;     // override auto-generated subject
12    cc?: string[];        // CC recipients
13    bcc?: string[];       // BCC recipients
14  }
15): Promise<{ id: string }>

1await mailer.send("NewsletterWelcome", [
2  "user1@example.com",
3  "user2@example.com",
4  "user3@example.com",
5], {
6  locale: "de",
7  brandName: "My Store",
8});

1{
2  "provider": "smtp",
3  "smtp": {
4    "host": "smtp.gmail.com",
5    "port": 587,
6    "secure": false,
7    "auth": {
8      "user": "your-email@gmail.com",
9      "pass": "your-app-password"
10    }
11  },
12  "from": "Your Brand <your-email@gmail.com>"
13}

1{
2  "theme": {
3    "designType": "ocean"
4  }
5}

1{
2  "theme": {
3    "designType": "midnight",
4    "colors": {
5      "primary": "#8B5CF6",
6      "accent": "#C084FC"
7    }
8  }
9}

1await mailer.send("OrderConfirmation", "kunde@example.de", {
2  locale: "de",
3  name: "Max Mustermann",
4  orderId: "ORD-99887",
5  items: [{ title: "Keramik Tasse", quantity: 1, price: "22.00", currency: "€" }],
6});

Customer & Account

Order Processing

Post-Purchase

Marketing

1npx guralnik-mailer preview

1# Email provider API key
2MAILER_API_KEY=re_your_api_key_here
3
4# Optional overrides
5MAILER_FROM="Your Brand <hello@your-domain.com>"
6MAILER_REPLY_TO=support@your-domain.com
7
8# SMTP-specific (only if using SMTP provider)
9SMTP_HOST=smtp.gmail.com
10SMTP_PORT=587
11SMTP_USER=your-email@gmail.com
12SMTP_PASS=your-app-password

1{
2  "provider": "resend",
3  "from": "Your Brand <hello@your-domain.com>",
4  "theme": {
5    "designType": "midnight"
6  },
7  "locale": "en"
8}

No. Guralnik Mailer works standalone with any Node.js project. The Medusa adapter is optional — you can use mailer.send() directly in Express, Fastify, Next.js API routes, or any backend.

Yes. All templates are React-based (using React Email under the hood). You can extend or override individual templates by placing custom versions in your project.

Yes. Guralnik Mailer is open-source under the MIT license. It's free to use in personal and commercial projects.

That depends on the provider. Resend offers a generous free tier (100 emails/day). SendGrid also has a free tier. AWS SES is pay-per-use at $0.10/1000 emails. SMTP depends on your server.

Yes. You can override or extend the built-in translations by providing custom translation files in your project. See the GitHub repository for the translation file format.

Yes. You can pass attachments in the options parameter of mailer.send(). Attachments support buffers, streams, and file paths.

Deliverability depends on your email provider and domain configuration (SPF, DKIM, DMARC). Guralnik Mailer generates clean, standards-compliant HTML that renders correctly across all major email clients.