plunk

SKILL.md

Plunk

Overview

Plunk is an open-source email platform for transactional emails (welcome, password reset, receipts) and marketing campaigns (newsletters, drip sequences). Self-hostable or use the cloud version. Simple API, React email templates.

Instructions

Step 1: Send Transactional Email

// lib/email.ts — Send emails via Plunk API
const PLUNK_API_KEY = process.env.PLUNK_API_KEY!

export async function sendEmail(to: string, subject: string, body: string) {
  await fetch('https://api.useplunk.com/v1/send', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${PLUNK_API_KEY}`,
    },
    body: JSON.stringify({ to, subject, body }),
  })
}

// Usage
await sendEmail('user@example.com', 'Welcome!', '<h1>Welcome to our app</h1>')

Step 2: Track Events (for Automations)

// Track user events to trigger automated emails
await fetch('https://api.useplunk.com/v1/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${PLUNK_API_KEY}`,
  },
  body: JSON.stringify({
    event: 'user-signed-up',
    email: 'user@example.com',
    data: { name: 'John', plan: 'free' },
  }),
})
// Configure automation in Plunk dashboard:
// When "user-signed-up" → send welcome email → wait 3 days → send onboarding tips

Guidelines

  • Free tier: 100 emails/month. Self-hosted: unlimited.
  • Use events + automations for drip campaigns instead of manual sends.
  • For higher volume, consider Resend or SendGrid.
  • Self-host with Docker for full control and unlimited emails.
Weekly Installs
1
GitHub Stars
15
First Seen
3 days ago
Installed on
amp1
cline1
augment1
opencode1
cursor1
kimi-cli1