create-loadout 1.0.0 → 1.0.1

package/README.md

@@ -76,6 +76,7 @@ your-app/
 | 🗄️  | **Neon + Drizzle** | Serverless Postgres with full CRUD example |
 | 🤖  | **AI SDK**         | OpenAI / Anthropic / Google                |
 | 📧  | **Resend**         | Email service + React email templates      |
+| 📬  | **Postmark**       | Transactional email with top deliverability |
 | 🔥  | **Firecrawl**      | Web scraping service                       |
 | ⏰  | **Inngest**        | Background jobs                            |
 | 📁  | **UploadThing**    | File uploads                               |

package/dist/claude-md.js

@@ -43,6 +43,13 @@ const stackSections = [
             { name: 'Resend', url: 'https://resend.com/docs', description: 'Email API' },
         ],
     },
+    {
+        id: 'postmark',
+        name: 'Email',
+        items: [
+            { name: 'Postmark', url: 'https://postmarkapp.com/developer', description: 'Transactional email' },
+        ],
+    },
     {
         id: 'firecrawl',
         name: 'Scraping',
@@ -142,8 +149,8 @@ npm run inngest:dev  # Start Inngest dev server for local testing
 ├── app/                    # Next.js App Router pages and API routes
 ├── components/             # React components (including shadcn/ui)
 `;
-    if (config.integrations.includes('resend')) {
-        content += `│   └── emails/             # React Email templates
+    if (config.integrations.includes('resend') || config.integrations.includes('postmark')) {
+        content += `│   └── emails/             # Email templates
 `;
     }
     if (hasPostHog || hasSentry) {

package/dist/config.js

@@ -14,6 +14,10 @@ const staticConfigVars = {
         { name: 'RESEND_API_KEY', envKey: 'RESEND_API_KEY', isPublic: false },
         { name: 'RESEND_FROM_EMAIL', envKey: 'RESEND_FROM_EMAIL', isPublic: false, defaultValue: 'onboarding@resend.dev' },
     ],
+    postmark: [
+        { name: 'POSTMARK_SERVER_TOKEN', envKey: 'POSTMARK_SERVER_TOKEN', isPublic: false },
+        { name: 'POSTMARK_FROM_EMAIL', envKey: 'POSTMARK_FROM_EMAIL', isPublic: false },
+    ],
     firecrawl: [
         { name: 'FIRECRAWL_API_KEY', envKey: 'FIRECRAWL_API_KEY', isPublic: false },
     ],

package/dist/detect.js

@@ -5,6 +5,7 @@ const integrationPackages = {
     'neon-drizzle': ['drizzle-orm', '@neondatabase/serverless'],
     'ai-sdk': ['ai'],
     resend: ['resend'],
+    postmark: ['postmark'],
     firecrawl: ['@mendable/firecrawl-js'],
     inngest: ['inngest'],
     uploadthing: ['uploadthing'],
@@ -49,6 +50,7 @@ export function getAvailableIntegrations(installed) {
         'neon-drizzle',
         'ai-sdk',
         'resend',
+        'postmark',
         'firecrawl',
         'inngest',
         'uploadthing',
@@ -56,5 +58,13 @@ export function getAvailableIntegrations(installed) {
         'posthog',
         'sentry',
     ];
-    return all.filter((id) => !installed.includes(id));
+    const emailProviders = ['resend', 'postmark'];
+    const hasEmail = emailProviders.some((id) => installed.includes(id));
+    return all.filter((id) => {
+        if (installed.includes(id))
+            return false;
+        if (hasEmail && emailProviders.includes(id))
+            return false;
+        return true;
+    });
 }

package/dist/env.js

@@ -29,6 +29,14 @@ const staticEnvSections = {
             { key: 'RESEND_FROM_EMAIL', example: 'onboarding@resend.dev', description: 'Default from email address' },
         ],
     },
+    postmark: {
+        name: 'POSTMARK - Email',
+        url: 'https://account.postmarkapp.com/servers',
+        vars: [
+            { key: 'POSTMARK_SERVER_TOKEN', example: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx', description: 'Postmark server token' },
+            { key: 'POSTMARK_FROM_EMAIL', example: 'hello@yourdomain.com', description: 'Default from email address' },
+        ],
+    },
     firecrawl: {
         name: 'FIRECRAWL - Scraping',
         url: 'https://firecrawl.dev',

package/dist/generate-readme.js

@@ -5,6 +5,7 @@ const integrationNames = {
     'neon-drizzle': 'Neon + Drizzle',
     'ai-sdk': 'Vercel AI SDK',
     resend: 'Resend',
+    postmark: 'Postmark',
     firecrawl: 'Firecrawl',
     inngest: 'Inngest',
     uploadthing: 'UploadThing',
@@ -89,7 +90,7 @@ npm run inngest:dev  # Start Inngest dev server
 ├── lib/           # Utilities and clients
 ├── services/      # Business logic
 `;
-    if (config.integrations.includes('resend')) {
+    if (config.integrations.includes('resend') || config.integrations.includes('postmark')) {
         content += `├── emails/        # Email templates\n`;
     }
     content += `└── public/        # Static assets

package/dist/integrations/index.js

@@ -7,6 +7,7 @@ import { firecrawlIntegration } from './firecrawl.js';
 import { inngestIntegration } from './inngest.js';
 import { uploadthingIntegration } from './uploadthing.js';
 import { stripeIntegration } from './stripe.js';
+import { postmarkIntegration } from './postmark.js';
 import { posthogIntegration } from './posthog.js';
 import { sentryIntegration } from './sentry.js';
 // Static integrations (don't need config)
@@ -18,6 +19,7 @@ const staticIntegrations = {
     inngest: inngestIntegration,
     uploadthing: uploadthingIntegration,
     stripe: stripeIntegration,
+    postmark: postmarkIntegration,
     posthog: posthogIntegration,
     sentry: sentryIntegration,
 };

package/dist/integrations/postmark.d.ts

@@ -0,0 +1,2 @@
+import type { Integration } from '../types.js';
+export declare const postmarkIntegration: Integration;

package/dist/integrations/postmark.js

@@ -0,0 +1,34 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { postmarkTemplates } from '../templates/postmark.js';
+export const postmarkIntegration = {
+    id: 'postmark',
+    name: 'Postmark',
+    description: 'Transactional email',
+    packages: ['postmark'],
+    envVars: [
+        {
+            key: 'POSTMARK_SERVER_TOKEN',
+            description: 'Postmark server token',
+            example: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+        },
+        {
+            key: 'POSTMARK_FROM_EMAIL',
+            description: 'Default from email address',
+            example: 'hello@yourdomain.com',
+        },
+    ],
+    setup: async (projectPath) => {
+        // Create email service
+        await fs.mkdir(path.join(projectPath, 'services'), { recursive: true });
+        await fs.writeFile(path.join(projectPath, 'services/email.service.ts'), postmarkTemplates.emailService);
+        // Create email templates in components/emails
+        await fs.mkdir(path.join(projectPath, 'components/emails'), { recursive: true });
+        await fs.writeFile(path.join(projectPath, 'components/emails/welcome.tsx'), postmarkTemplates.welcomeEmail);
+        // Create API route
+        await fs.mkdir(path.join(projectPath, 'app/api/email/send'), {
+            recursive: true,
+        });
+        await fs.writeFile(path.join(projectPath, 'app/api/email/send/route.ts'), postmarkTemplates.sendRoute);
+    },
+};

package/dist/landing-page.js

@@ -13,6 +13,7 @@ const integrationTechnologies = {
     'neon-drizzle': { name: 'Neon + Drizzle', href: 'https://neon.tech/docs', description: 'Serverless Postgres' },
     'ai-sdk': { name: 'AI SDK', href: 'https://sdk.vercel.ai/docs', description: 'AI integration' },
     resend: { name: 'Resend', href: 'https://resend.com/docs', description: 'Email API' },
+    postmark: { name: 'Postmark', href: 'https://postmarkapp.com/developer', description: 'Transactional email' },
     firecrawl: { name: 'Firecrawl', href: 'https://docs.firecrawl.dev', description: 'Web scraping' },
     inngest: { name: 'Inngest', href: 'https://www.inngest.com/docs', description: 'Background jobs' },
     uploadthing: { name: 'UploadThing', href: 'https://docs.uploadthing.com', description: 'File uploads' },

package/dist/prompts.js

@@ -35,8 +35,15 @@ export async function getProjectConfig() {
         });
     }
     // Email
-    if (await confirm({ message: 'Add Resend for email?', default: false })) {
-        integrations.push('resend');
+    if (await confirm({ message: 'Add email?', default: false })) {
+        const emailProvider = await select({
+            message: 'Which email provider?',
+            choices: [
+                { value: 'resend', name: 'Resend (Modern DX, React Email templates)' },
+                { value: 'postmark', name: 'Postmark (Best-in-class deliverability, fast transactional email)' },
+            ],
+        });
+        integrations.push(emailProvider);
     }
     // Scraping
     if (await confirm({ message: 'Add Firecrawl for web scraping?', default: false })) {
@@ -68,7 +75,8 @@ const integrationPrompts = {
     clerk: 'Add Clerk for authentication?',
     'neon-drizzle': 'Add Neon + Drizzle for database?',
     'ai-sdk': 'Add Vercel AI SDK?',
-    resend: 'Add Resend for email?',
+    resend: 'Add email?',
+    postmark: 'Add email?',
     firecrawl: 'Add Firecrawl for web scraping?',
     inngest: 'Add Inngest for background jobs?',
     uploadthing: 'Add UploadThing for file uploads?',
@@ -79,7 +87,26 @@ const integrationPrompts = {
 export async function getAddIntegrationConfig(available) {
     const integrations = [];
     let aiProvider;
+    const emailProviders = ['resend', 'postmark'];
+    let emailPromptShown = false;
     for (const id of available) {
+        // For email providers, show a single confirm + select prompt
+        if (emailProviders.includes(id)) {
+            if (emailPromptShown)
+                continue;
+            emailPromptShown = true;
+            if (await confirm({ message: 'Add email?', default: false })) {
+                const emailProvider = await select({
+                    message: 'Which email provider?',
+                    choices: [
+                        { value: 'resend', name: 'Resend (Modern DX, React Email templates)' },
+                        { value: 'postmark', name: 'Postmark (Best-in-class deliverability, fast transactional email)' },
+                    ],
+                });
+                integrations.push(emailProvider);
+            }
+            continue;
+        }
         const message = integrationPrompts[id];
         if (await confirm({ message, default: false })) {
             integrations.push(id);

package/dist/templates/postmark.d.ts

@@ -0,0 +1,5 @@
+export declare const postmarkTemplates: {
+    emailService: string;
+    welcomeEmail: string;
+    sendRoute: string;
+};

package/dist/templates/postmark.js

@@ -0,0 +1,103 @@
+export const postmarkTemplates = {
+    emailService: `import { ServerClient } from 'postmark';
+import type { ReactElement } from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+import { POSTMARK_SERVER_TOKEN, POSTMARK_FROM_EMAIL } from '@/lib/config';
+
+export interface SendEmailOptions {
+  to: string | string[];
+  subject: string;
+  react: ReactElement;
+  from?: string;
+  replyTo?: string;
+}
+
+export class EmailService {
+  private client: ServerClient;
+  private defaultFrom: string;
+
+  constructor(serverToken: string, defaultFrom: string) {
+    this.client = new ServerClient(serverToken);
+    this.defaultFrom = defaultFrom;
+  }
+
+  async send(options: SendEmailOptions) {
+    const htmlBody = renderToStaticMarkup(options.react);
+    const to = Array.isArray(options.to) ? options.to.join(',') : options.to;
+
+    const result = await this.client.sendEmail({
+      From: options.from || this.defaultFrom,
+      To: to,
+      Subject: options.subject,
+      HtmlBody: htmlBody,
+      ReplyTo: options.replyTo,
+      MessageStream: 'outbound',
+    });
+
+    return { id: result.MessageID };
+  }
+
+  async sendWelcome(to: string, name: string) {
+    const { WelcomeEmail } = await import('@/components/emails/welcome');
+    return this.send({
+      to,
+      subject: 'Welcome!',
+      react: WelcomeEmail({ name }),
+    });
+  }
+}
+
+export const emailService = new EmailService(POSTMARK_SERVER_TOKEN, POSTMARK_FROM_EMAIL);
+`,
+    welcomeEmail: `import * as React from 'react';
+
+interface WelcomeEmailProps {
+  name: string;
+}
+
+export function WelcomeEmail({ name }: WelcomeEmailProps) {
+  return (
+    <div style={{ fontFamily: 'sans-serif', padding: '20px' }}>
+      <h1 style={{ color: '#333' }}>Welcome, {name}!</h1>
+      <p style={{ color: '#666', lineHeight: 1.6 }}>
+        Thanks for signing up. We're excited to have you on board.
+      </p>
+      <p style={{ color: '#666', lineHeight: 1.6 }}>
+        If you have any questions, feel free to reply to this email.
+      </p>
+    </div>
+  );
+}
+`,
+    sendRoute: `import { NextResponse } from 'next/server';
+import { emailService } from '@/services/email.service';
+import { z } from 'zod';
+
+const sendEmailSchema = z.object({
+  to: z.email(),
+  name: z.string().min(1),
+});
+
+export async function POST(req: Request) {
+  try {
+    const body = await req.json();
+    const { to, name } = sendEmailSchema.parse(body);
+
+    const data = await emailService.sendWelcome(to, name);
+
+    return NextResponse.json(data);
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { error: 'Invalid request', details: error.errors },
+        { status: 400 }
+      );
+    }
+    return NextResponse.json(
+      { error: error instanceof Error ? error.message : 'Failed to send email' },
+      { status: 500 }
+    );
+  }
+}
+`,
+};

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type IntegrationId = 'clerk' | 'neon-drizzle' | 'ai-sdk' | 'resend' | 'firecrawl' | 'inngest' | 'uploadthing' | 'stripe' | 'posthog' | 'sentry';
+export type IntegrationId = 'clerk' | 'neon-drizzle' | 'ai-sdk' | 'resend' | 'firecrawl' | 'inngest' | 'uploadthing' | 'stripe' | 'postmark' | 'posthog' | 'sentry';
 export interface Integration {
     id: IntegrationId;
     name: string;

package/package.json

@@ -1,46 +1,46 @@
-{
-  "name": "create-loadout",
-  "version": "1.0.0",
-  "description": "Custom Next.js scaffolding CLI with optional SaaS integrations",
-  "type": "module",
-  "bin": {
-    "create-loadout": "./dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "nextjs",
-    "cli",
-    "scaffolding",
-    "saas",
-    "boilerplate"
-  ],
-  "author": {
-    "name": "Kyle Davidson"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/kylerd/loadout.git"
-  },
-  "license": "MIT",
-  "dependencies": {
-    "@inquirer/prompts": "^7.0.0",
-    "chalk": "^5.0.0",
-    "ora": "^8.0.0",
-    "execa": "^9.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.0.0",
-    "tsx": "^4.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "create-loadout",
+  "version": "1.0.1",
+  "description": "Custom Next.js scaffolding CLI with optional SaaS integrations",
+  "type": "module",
+  "bin": {
+    "create-loadout": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "nextjs",
+    "cli",
+    "scaffolding",
+    "saas",
+    "boilerplate"
+  ],
+  "author": {
+    "name": "Kyle Davidson"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kylerd/loadout.git"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.0.0",
+    "ora": "^8.0.0",
+    "execa": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}