svelte-email-tailwind

v1.0.2

Published

2 months ago

Build emails with Svelte and Tailwind

Downloads

0High
0Medium
0Low

steveninety

svelte email tailwind sveltekit resend

Introduction

svelte-email-tailwind enables you to code, preview and test-send email templates with Svelte and Tailwind classes and render them to HTML or plain text.

This package adds a Tailwind post-processor to the original svelte-email package.
Tailwind classes are converted to inline styles on built-time using a Vite plugin.
In earlier versions, this process took place every time an email was sent (not very efficient).
This package also provides a Svelte preview component, including utility functions for the server (SvelteKit only).

Installation

Install the package to your existing Svelte + Vite or SvelteKit project:

npm install svelte-email-tailwind

pnpm install svelte-email-tailwind

Getting started

1. Configure Vite

Import the svelteEmailTailwind Vite plugin, and pass it into the config's plugins array.

vite.config.ts

import { sveltekit } from '@sveltejs/kit/vite';
import type { UserConfig } from 'vite';
import svelteEmailTailwind from 'svelte-email-tailwind/vite';

const config: UserConfig = {
  plugins: [
    sveltekit(),
    svelteEmailTailwind() // processes .svelte files inside the default '/src/lib/emails' folder
  ],
};

export default config;

Optional configurations:

Provide a Tailwind config;
Provide a custom path to your email folder.

import { sveltekit } from '@sveltejs/kit/vite';
import type { UserConfig } from 'vite';
import type { TailwindConfig } from 'tw-to-css';
import svelteEmailTailwind from 'svelte-email-tailwind/vite';

const emailTwConfig: TailwindConfig = {
  theme: {
    screens: {
      md: { max: '767px' },
      sm: { max: '475px' }
    },
    extend: {
      colors: {
        brand: 'rgb(255, 62, 0)'
      }
    }
  }
}

const config: UserConfig = {
  plugins: [
    sveltekit(),
    svelteEmailTailwind({
      tailwindConfig: emailTwConfig,
      pathToEmailFolder: '/src/lib/components/emails' // defaults to '/src/lib/emails'
    })
  ],
};

export default config;

2. Create an email using Svelte

src/lib/emails/Hello.svelte

<script>
	import { Button, Hr, Html, Text, Head } from 'svelte-email-tailwind';

	export let name = 'World';
</script>

<Html lang="en">
  <Head />
	<Text class="md:text-[18px] text-[24px]">
		Hello, {name}!
	</Text>
	<Hr />
	<Button href="https://svelte.dev">Visit Svelte</Button>
</Html>

3. Render & send an email

This example uses Resend to send the email. You can use any other email service provider (Nodemailer, SendGrid, Postmark, AWS SES...).

src/routes/emails/hello/+server.ts

import type { ComponentProps } from 'svelte';
import type HelloProps from 'src/lib/emails/Hello.svelte';
import Hello from 'src/lib/emails/Hello.svelte';
import { PRIVATE_RESEND_API_KEY } from '$env/static/private'
import { Resend } from 'resend';

const componentProps: ComponentProps<HelloProps> = {
    name: "Steven"
}

const emailHtml = Hello.render(componentProps)

const resend = new Resend(PRIVATE_RESEND_API_KEY);

// Send the email using your provider of choice.
resend.emails.send({
    from: '[email protected]',
    to: '[email protected]',
    subject: 'Hello',
    html: emailHtml
});

Previewing & test-sending emails in development (SvelteKit)

Using a designated route, you can preview all your dynamically retrieved email components. This means you'll be able to preview your emails with the exact markup that eventually lands an inbox (unless of course, the email provider manipulates it behind the scenes).

svelte-email-tailwind-preview-interface

To get started...

1. Configure a route

Import the Preview component and pass in the server data as a prop. Customize the email address.

src/routes/email-previews/+page.svelte

<script lang="ts">
	import Preview from 'svelte-email-tailwind/preview/preview.svelte';
	export let data;
</script>

<Preview {data} email="[email protected]" />

2. Configure the server for this route

Return the email component file list from SvelteKit's load function using the emailList function. In SvelteKit's form actions, pass in createEmail (loads files from the server), and sendEmail (sends test-emails).

src/routes/email-previews/+page.server.ts

import { createEmail, emailList, sendEmail } from 'svelte-email-tailwind/preview';
import { PRIVATE_RESEND_API_KEY } from '$env/static/private'

export async function load() {
  // return the list of email components
  return emailList({})
}

export const actions = {
  // Pass in the two actions. Provide your Resend API key.
  ...createEmail,
  ...sendEmail({ resendApiKey: PRIVATE_RESEND_API_KEY })
}

Optional configurations:

Provide a custom path to your email components;
Provide a custom function to send the email using a different provider.

import { createEmail, emailList, sendEmail, SendEmailFunction } from 'svelte-email-tailwind/preview';
import nodemailer from 'nodemailer';

export async function load() {
  // Customize the path to your email components.
  return emailList({ path: '/src/lib/components/emails' })
}

// Make sure your custom 'send email' function follows the type of 'SendEmailFunction'.
const sendUsingNodemailer: typeof SendEmailFunction = async ({ from, to, subject, html }) => {
  const transporter = nodemailer.createTransport({
	  host: 'smtp.ethereal.email',
	  port: 587,
	  secure: false,
	  auth: {
		  user: 'my_user',
		  pass: 'my_password'
	  }
  });

  const sent = await transporter.sendMail({ from, to, subject, html });

  if (sent.error) {
    return { success: false, error: sent.error }
  } else {
    return { success: true }
  }
}

export const actions = {
  ...createEmail,
  // Pass in your custom 'send email' function.
  ...sendEmail({ customSendEmailFunction: sendUsingNodemailer })
}

3. Start developing your emails via the route you've chosen.

Example: http://localhost:5173/email-previews

Components

A set of standard components to help you build amazing emails without having to deal with the mess of creating table-based layouts and maintaining archaic markup.

HTML
Head
Heading
Button
Link
Img
Hr
Text
Container
Preview
Body
Column
Section
Row
Custom

HEADS UP!

Always include the <Head /> component.
For now, class attribute/prop interpolation/variable references will not work (this won't work: class={someTwClassName}, class={${someTwClassName} w-full}, this will work: class="w-full").
When using arbitrary Tailwind classes that use multiple values, separate them using underscores (example: p-[0_30px_12px_5px]).
In Svelte email components, stick to the designated components if you use Tailwind classes. If you need custom HTML, use the <Custom /> component and the "as" property to define the tag. This component defaults to a <div/>. Tailwind classes on regular html nodes will not be processed.

Author

Steven Polak

Author of the original Svelte Email package

Carsten Lebek (@carstenlebek)

Authors of the original project react-email

Bu Kinoshita (@bukinoshita)
Zeno Rocha (@zenorocha)