create-ej-app 15.0.0 → 16.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Ekansh Jain
+Copyright (c) 2026 Ekansh Jain
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,5 +1,238 @@
 # create-ej-app
 
+A no-bullshit CLI to bootstrap a production-ready **fucking beast** of a app with Next.js, Better Auth, Drizzle ORM, Elysia, Workflow, shadcn/ui, React Email, and deployment wired up so you don’t screw your shit up in production.
+
+```bash
+bunx create-ej-app@latest
 ```
-npx create-ej-app@latest
+
+---
+
+## ✨ Features (aka the good shit)
+
+- **Next.js 16** – Powered by React 19, Server Components, App Router. Fast as hell.
+- **Better Auth** – Auth that doesn’t suck:
+  - Email/Password
+  - Magic link (because passwords are annoying as fuck)
+  - OAuth with GitHub and Google
+  - Account linking
+  - Admin powers
+
+- **Drizzle ORM** – Type-safe SQL over PostgreSQL without the usual ORM garbage.
+- **Elysia** – Built for Bun. Minimal, fast, no nonsense.
+- **Workflow** – Durable jobs so your background tasks don’t randomly die like weak shit.
+- **React Email** – Build transactional emails using React components instead of ugly HTML nightmares.
+- **shadcn/ui** – Clean, accessible components built on Radix UI.
+- **TailwindCSS 4** – Utility-first styling with zero CSS drama.
+- **TypeScript** – Strict types so you don’t ship dumb bugs.
+- **TanStack Query** – Server state that doesn’t implode.
+- **Lucide React** – Icons that don’t look like 2009 garbage.
+- **Docker + Terraform** – Ship this shit properly.
+- Terraform setup for Google Cloud Platform so you don’t YOLO infra.
+
+---
+
+## 🚀 Quick Start (Let’s fucking go)
+
+```bash
+bunx create-ej-app@latest
 ```
+
+You’ll be prompted for:
+
+- Project name
+- Description
+- Template
+- Git init (because not using git in 2026 is wild)
+
+Example:
+
+```bash
+? Enter the project name: badass-app
+? Enter a description: My savage Next.js monster
+? Select a template: base
+? Initialize a git repository? yes
+```
+
+Boom. Done.
+
+---
+
+## 📦 What You Actually Get
+
+### Tech Stack (The real weapons)
+
+- **Framework**: Next.js
+- **Runtime**: Bun (fast as shit)
+- **Backend**: Elysia APIs
+- **Database**: PostgreSQL + Drizzle
+- **Auth**: Better Auth
+- **Emails**: React Email (transactional + auth templates ready)
+- **Background Jobs**: Workflow
+- **UI**: shadcn/ui
+- **Styling**: TailwindCSS
+- **State**: TanStack Query
+- **Forms**: react-hook-form + Zod
+- **Theme**: Dark mode out of the box
+
+---
+
+## 🛠 Setup & Development
+
+### Prerequisites
+
+- Node 24+ or Bun
+- PostgreSQL running
+- OAuth creds if you want GitHub/Google login
+- Email provider (Resend, SES, Postmark, etc.)
+
+### Install
+
+```bash
+cd my-app
+bun install
+# or npm / pnpm / yarn if that’s your thing
+```
+
+---
+
+### Environment Variables
+
+Copy `.env.example` → `.env` and fill your secrets like a responsible adult.
+
+Don’t commit this crap. Seriously.
+
+---
+
+## 💻 Development
+
+```bash
+bun run dev
+```
+
+Open `http://localhost:3000` and admire your badass setup.
+
+---
+
+## 🐳 Docker (Ship it like a pro)
+
+```bash
+docker build -t my-app .
+docker run -p 3000:3000 my-app
+```
+
+No “works on my machine” bullshit anymore.
+
+---
+
+## ☁️ Infrastructure (The Cloud Shit)
+
+Terraform config included for:
+
+- Cloud Run
+- Cloud SQL
+- Artifact Registry
+- Cloud Build
+- Secret Manager
+- Load Balancer
+- VPC
+
+Deploy it:
+
+```bash
+cd terraform
+terraform init
+terraform apply
+```
+
+And now you’re running production infra like a grown-ass engineer.
+
+---
+
+## 🔐 Authentication
+
+Better Auth gives you:
+
+- Email/Password login
+- Magic links (no password drama)
+- OAuth (GitHub, Google)
+- Admin panel
+- User impersonation
+
+Secure, extensible, no duct-taped auth spaghetti.
+
+---
+
+## 🎨 UI Components
+
+Preinstalled:
+
+- Button
+- Card
+- Form
+- Input
+- Toast notifications
+
+Need more?
+
+```bash
+bunx shadcn@latest add [component-name]
+```
+
+Ship beautiful shit without reinventing buttons for the 900th time.
+
+---
+
+## 🎯 Route Groups
+
+Organized like a sane human:
+
+- `(admin)` – Admin dashboard
+- `(app)` – Main app (auth required)
+- `(auth)` – Login/signup
+- `(marketing)` – Public pages
+
+No messy folder hell.
+
+---
+
+## 🔧 Customization
+
+Edit:
+
+- `siteConfig.ts` – change name/description
+- `schema.ts` – change DB schema
+- `auth.ts` – tweak providers
+
+Then push schema and move on with your life.
+
+---
+
+## 🤝 Contributing
+
+PRs welcome. Don’t submit half-broken shit.
+
+---
+
+## 📄 License
+
+MIT. Do whatever the hell you want, just don’t blame us if you screw it up.
+
+---
+
+## 🔗 Links
+
+- Repository: [https://github.com/ejekanshjain/create-ej-app](https://github.com/ejekanshjain/create-ej-app)
+- Issues: [https://github.com/ejekanshjain/create-ej-app/issues](https://github.com/ejekanshjain/create-ej-app/issues)
+- Docs:
+  - [Next.js](https://nextjs.org/docs)
+  - [Better Auth](https://better-auth.com)
+  - [Drizzle ORM](https://orm.drizzle.team)
+  - [Elysia](https://elysiajs.com)
+  - [Workflow](https://useworkflow.dev)
+  - [shadcn/ui](https://ui.shadcn.com)
+  - [React Email](https://react.email)
+
+---
+
+Now go build some badass production-ready shit instead of another half-baked side project. 🚀

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ej-app",
-  "version": "15.0.0",
+  "version": "16.0.0",
   "description": "Bootstrap a next.js app with my preferred setup",
   "main": "cli.js",
   "scripts": {

package/template/base/package.json

@@ -5,6 +5,9 @@
   "private": true,
   "scripts": {
     "dev": "next dev",
+    "email:dev": "email dev --dir src/emails",
+    "email:test": "bun ./src/scripts/test-mail.ts",
+    "workflow:inspect": "workflow inspect runs --web",
     "build": "bun --bun next build",
     "build:docker": "docker build -t my-app .",
     "analyze": "ANALYZE=true bun --bun next build --webpack",
@@ -17,19 +20,23 @@
     "gen:auth": "bunx @better-auth/cli generate"
   },
   "dependencies": {
-    "@ejekanshjain/simple-email-validator": "1.0.2",
+    "@ejekanshjain/simple-email-validator": "1.0.3",
+    "@elysiajs/eden": "1.4.8",
     "@hookform/resolvers": "5.2.2",
     "@next/third-parties": "16.1.6",
     "@paralleldrive/cuid2": "3.3.0",
     "@radix-ui/react-label": "2.1.8",
     "@radix-ui/react-separator": "1.1.8",
     "@radix-ui/react-slot": "1.2.4",
+    "@react-email/components": "1.0.7",
+    "@react-email/render": "2.0.4",
     "@t3-oss/env-nextjs": "0.13.10",
     "@tanstack/react-query": "5.90.21",
     "better-auth": "1.4.18",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
     "drizzle-orm": "0.45.1",
+    "elysia": "1.4.25",
     "lucide-react": "0.563.0",
     "next": "16.1.6",
     "next-safe-action": "8.0.11",
@@ -43,11 +50,12 @@
     "sonner": "2.0.7",
     "tailwind-merge": "3.4.0",
     "tw-animate-css": "1.4.0",
-    "workflow": "4.1.0-beta.55",
+    "workflow": "4.1.0-beta.56",
     "zod": "4.3.6"
   },
   "devDependencies": {
     "@next/bundle-analyzer": "16.1.6",
+    "@react-email/preview-server": "5.2.8",
     "@tailwindcss/postcss": "4.1.18",
     "@types/bun": "1.3.9",
     "@types/nodemailer": "7.0.9",
@@ -60,7 +68,16 @@
     "prettier": "3.8.1",
     "prettier-plugin-organize-imports": "4.3.0",
     "prettier-plugin-tailwindcss": "0.7.2",
+    "react-email": "5.2.8",
     "tailwindcss": "4.1.18",
     "typescript": "5.9.3"
-  }
+  },
+  "trustedDependencies": [
+    "@nestjs/core",
+    "@swc/core",
+    "cbor-extract",
+    "esbuild",
+    "sharp",
+    "unrs-resolver"
+  ]
 }

package/template/base/src/app/(admin)/admin/page.tsx

@@ -0,0 +1,3 @@
+export default async function AdminPage() {
+  return <div>Hello Admin</div>
+}

package/template/base/src/app/api/[[...slugs]]/route.ts

@@ -0,0 +1,25 @@
+import { Elysia } from 'elysia'
+import z from 'zod'
+
+export const elysiaApi = new Elysia({ prefix: '/api' })
+  .get('/', 'Hello from Elysia')
+  .post(
+    '/',
+    ({ body }) => {
+      return `Hello, ${body.name}!`
+    },
+    {
+      body: z.object({
+        name: z.string().trim().min(1).describe('Name of the user')
+      }),
+      detail: {
+        description: 'Greet a user by name'
+      }
+    }
+  )
+
+export const GET = elysiaApi.fetch
+export const POST = elysiaApi.fetch
+export const PUT = elysiaApi.fetch
+export const PATCH = elysiaApi.fetch
+export const DELETE = elysiaApi.fetch

package/template/base/src/emails/components/email-layout.tsx

@@ -0,0 +1,63 @@
+import {
+  Body,
+  Container,
+  Head,
+  Hr,
+  Html,
+  pixelBasedPreset,
+  Preview,
+  Section,
+  Tailwind,
+  Text
+} from '@react-email/components'
+
+interface EmailLayoutProps {
+  previewText: string
+  companyName: string
+  children: React.ReactNode
+}
+
+export default function EmailLayout({
+  previewText,
+  companyName,
+  children
+}: EmailLayoutProps) {
+  return (
+    <Html>
+      <Head />
+      <Preview>{previewText}</Preview>
+      <Tailwind
+        config={{
+          presets: [pixelBasedPreset]
+        }}
+      >
+        <Body className="bg-gray-100 font-sans">
+          <Container className="mx-auto my-8 max-w-xl rounded-lg bg-white shadow-sm">
+            {/* Header */}
+            <Section className="rounded-t-lg bg-black px-8 py-6">
+              <Text className="m-0 text-center text-2xl font-bold text-white">
+                {companyName}
+              </Text>
+            </Section>
+
+            {/* Content */}
+            <Section className="px-8 py-6">{children}</Section>
+
+            {/* Footer */}
+            <Section className="rounded-b-lg bg-gray-50 px-8 py-6">
+              <Hr className="my-4 border-gray-200" />
+              <Text className="m-0 text-center text-sm text-gray-500">
+                &copy; {new Date().getUTCFullYear()} {companyName}. All rights
+                reserved.
+              </Text>
+              <Text className="m-0 mt-2 text-center text-xs text-gray-400">
+                This is an automated email. Please do not reply directly to this
+                message.
+              </Text>
+            </Section>
+          </Container>
+        </Body>
+      </Tailwind>
+    </Html>
+  )
+}

package/template/base/src/emails/magic-link.tsx

@@ -0,0 +1,49 @@
+import { Button, Heading, Text } from '@react-email/components'
+import EmailLayout from './components/email-layout'
+
+export interface MagicLinkEmailProps {
+  magicLink: string
+  companyName: string
+}
+
+export default function MagicLinkEmail({
+  magicLink,
+  companyName
+}: MagicLinkEmailProps) {
+  const previewText = `Your magic link to sign in to ${companyName}`
+
+  return (
+    <EmailLayout previewText={previewText} companyName={companyName}>
+      <Heading className="mb-4 text-2xl font-bold text-gray-900">
+        Sign in to {companyName}
+      </Heading>
+
+      <Text className="mb-4 text-base text-gray-700">
+        Click the button below to securely sign in to your account. This link
+        will expire in 5 minutes.
+      </Text>
+
+      <Button
+        href={magicLink}
+        className="mb-4 rounded-lg bg-black px-6 py-3 text-center text-base font-semibold text-white no-underline"
+      >
+        Sign In
+      </Button>
+
+      <Text className="mb-4 text-sm text-gray-600">
+        Or copy and paste this link into your browser:
+      </Text>
+
+      <Text className="mb-4 text-sm break-all text-blue-600">{magicLink}</Text>
+
+      <Text className="text-sm text-gray-500">
+        If you didn't request this email, you can safely ignore it.
+      </Text>
+    </EmailLayout>
+  )
+}
+
+MagicLinkEmail.PreviewProps = {
+  magicLink: 'https://example.com/magic-link?token=abc123',
+  companyName: 'Example Site'
+} satisfies MagicLinkEmailProps

package/template/base/src/emails/test.tsx

@@ -0,0 +1,32 @@
+import { Button, Heading, Text } from '@react-email/components'
+import EmailLayout from './components/email-layout'
+
+interface TestEmailProps {
+  name: string
+}
+
+export default function TestEmail({ name }: TestEmailProps) {
+  return (
+    <EmailLayout previewText="This is a test email" companyName="Test">
+      <Heading className="mb-4 text-2xl font-bold text-gray-900">
+        Test Email for {name}
+      </Heading>
+      <Text className="mb-4 text-base text-gray-700">
+        This is a test email template to verify email functionality.
+      </Text>
+      <Text className="mb-6 text-base text-gray-700">
+        If you're seeing this, the email system is working correctly.
+      </Text>
+      <Button
+        href="https://example.com"
+        className="rounded-md bg-black px-5 py-3 text-center text-sm font-medium text-white"
+      >
+        Test Button
+      </Button>
+    </EmailLayout>
+  )
+}
+
+TestEmail.PreviewProps = {
+  name: 'John Doe'
+}

package/template/base/src/emails/welcome.tsx

@@ -0,0 +1,34 @@
+import { Heading, Text } from '@react-email/components'
+import EmailLayout from './components/email-layout'
+
+export interface WelcomeEmailProps {
+  userName: string
+  companyName: string
+}
+
+export default function WelcomeEmail({
+  userName,
+  companyName
+}: WelcomeEmailProps) {
+  const previewText = `Welcome to ${companyName}! Your account has been created successfully.`
+
+  return (
+    <EmailLayout previewText={previewText} companyName={companyName}>
+      <Heading className="mb-4 text-2xl font-bold text-gray-900">
+        Welcome to {companyName}! 🎉
+      </Heading>
+
+      <Text className="mb-4 text-base text-gray-700">Hi {userName},</Text>
+
+      <Text className="mb-4 text-base text-gray-700">
+        Thank you for creating an account with us. We're thrilled to have you as
+        part of our community!
+      </Text>
+    </EmailLayout>
+  )
+}
+
+WelcomeEmail.PreviewProps = {
+  userName: 'John Doe',
+  companyName: 'Example Site'
+} satisfies WelcomeEmailProps

package/template/base/src/lib/auth.ts

@@ -10,6 +10,7 @@ import {
 } from 'better-auth/plugins'
 import { headers } from 'next/headers'
 import { cache } from 'react'
+import { start } from 'workflow/api'
 import { db } from '~/db'
 import {
   accountsTable,
@@ -18,6 +19,8 @@ import {
   verificationsTable
 } from '~/db/schema'
 import { env } from '~/env'
+import { sendMagicLinkEmail, sendWelcomeEmail } from './email-service'
+import { siteConfig } from './siteConfig'
 
 export const auth = betterAuth({
   database: drizzleAdapter(db, {
@@ -51,14 +54,39 @@ export const auth = betterAuth({
       clientSecret: env.BETTER_AUTH_GOOGLE_SECRET
     }
   },
+  databaseHooks: {
+    user: {
+      create: {
+        after: async user => {
+          try {
+            await start(sendWelcomeEmail, [
+              user.email,
+              {
+                userName: user.name,
+                companyName: siteConfig.name
+              }
+            ])
+          } catch (error) {
+            console.error('Failed to send welcome email:', error)
+          }
+        }
+      }
+    }
+  },
   plugins: [
     magicLink({
-      sendMagicLink: async ({ email, token, url }) => {
-        console.warn('TODO: send email', {
-          email,
-          token,
-          url
-        })
+      sendMagicLink: async ({ email, url }) => {
+        try {
+          await start(sendMagicLinkEmail, [
+            email,
+            {
+              magicLink: url,
+              companyName: siteConfig.name
+            }
+          ])
+        } catch (error) {
+          console.error('Failed to send magic link email:', error)
+        }
       }
     }),
     admin(),
@@ -66,10 +94,7 @@ export const auth = betterAuth({
   ],
   hooks: {
     before: createAuthMiddleware(async ctx => {
-      if (
-        ctx.path === '/sign-in/magic-link' &&
-        ctx.body?.email
-      ) {
+      if (ctx.path === '/sign-in/magic-link' && ctx.body?.email) {
         try {
           const validation = await validateEmail({
             email: ctx.body.email

package/template/base/src/lib/eden.ts

@@ -0,0 +1,7 @@
+import { treaty } from '@elysiajs/eden'
+import { elysiaApi } from '~/app/api/[[...slugs]]/route'
+
+export const api =
+  typeof process !== 'undefined'
+    ? treaty(elysiaApi).api
+    : treaty<typeof elysiaApi>(window.location.host).api

package/template/base/src/lib/email-service.ts

@@ -0,0 +1,70 @@
+import { render, toPlainText } from '@react-email/render'
+import MagicLinkEmail, { MagicLinkEmailProps } from '~/emails/magic-link'
+import WelcomeEmail, { WelcomeEmailProps } from '~/emails/welcome'
+import { sendEmail } from './nodemailer'
+
+/**
+ * Mapping of template types to their corresponding props
+ */
+type EmailTemplateMap = {
+  welcome: WelcomeEmailProps
+  magicLink: MagicLinkEmailProps
+}
+
+type EmailTemplateType = keyof EmailTemplateMap
+
+// Map of email template components with proper type safety
+const componentMap: Record<
+  EmailTemplateType,
+  (props: EmailTemplateMap[EmailTemplateType]) => React.ReactElement
+> = {
+  welcome: props => WelcomeEmail(props as WelcomeEmailProps),
+  magicLink: props => MagicLinkEmail(props as MagicLinkEmailProps)
+}
+
+async function renderEmailTemplate<T extends EmailTemplateType>(
+  templateType: T,
+  props: EmailTemplateMap[T]
+): Promise<{ html: string; text: string }>
+
+async function renderEmailTemplate(
+  templateType: EmailTemplateType,
+  props: EmailTemplateMap[EmailTemplateType]
+) {
+  'use step'
+
+  const emailComponent = componentMap[templateType](props)
+
+  const html = await render(emailComponent)
+  const text = toPlainText(html)
+  return { html, text }
+}
+
+export async function sendWelcomeEmail(to: string, props: WelcomeEmailProps) {
+  'use workflow'
+
+  const { html, text } = await renderEmailTemplate('welcome', props)
+
+  return await sendEmail({
+    to,
+    subject: `Welcome to ${props.companyName}! 🎉`,
+    html,
+    text
+  })
+}
+
+export async function sendMagicLinkEmail(
+  to: string,
+  props: MagicLinkEmailProps
+) {
+  'use workflow'
+
+  const { html, text } = await renderEmailTemplate('magicLink', props)
+
+  return await sendEmail({
+    to,
+    subject: `Sign in to ${props.companyName}`,
+    html,
+    text
+  })
+}

package/template/base/src/lib/nodemailer.ts

@@ -0,0 +1,43 @@
+import nodemailer, { SentMessageInfo } from 'nodemailer'
+import { env } from '~/env'
+
+const transporter = nodemailer.createTransport({
+  host: env.EMAIL_SERVER_HOST,
+  port: parseInt(env.EMAIL_SERVER_PORT),
+  secure: parseInt(env.EMAIL_SERVER_PORT) === 465, // Use secure for port 465, false for other ports
+  auth: {
+    user: env.EMAIL_SERVER_USER,
+    pass: env.EMAIL_SERVER_PASSWORD
+  }
+})
+
+interface SendEmailParams {
+  to: string
+  subject: string
+  text?: string
+  html?: string
+}
+
+export const sendEmail = async ({
+  to,
+  subject,
+  text,
+  html
+}: SendEmailParams): Promise<SentMessageInfo> => {
+  'use step'
+
+  try {
+    const info = await transporter.sendMail({
+      from: env.EMAIL_FROM,
+      to,
+      subject,
+      text,
+      html
+    })
+
+    return info
+  } catch (error) {
+    console.error('Error sending email:', error)
+    throw new Error('Failed to send email')
+  }
+}

package/template/base/src/scripts/test-mail.ts

@@ -0,0 +1,29 @@
+import { render, toPlainText } from '@react-email/render'
+import TestEmail from '~/emails/test'
+import { sendEmail } from '~/lib/nodemailer'
+
+async function main() {
+  const html = await render(
+    TestEmail({
+      name: 'Ekansh Jain'
+    }),
+    {
+      pretty: true
+    }
+  )
+
+  const text = toPlainText(html)
+
+  const result = await sendEmail({
+    to: 'john@example.com',
+    subject: 'Test Email',
+    text,
+    html
+  })
+
+  console.info('Test email sent successfully', result)
+
+  process.exit()
+}
+
+main()

package/template/base/terraform/cloudrun.tf

@@ -33,7 +33,7 @@ resource "google_cloud_run_v2_service" "my_app_prod" {
           cpu    = "1000m"
           memory = "1Gi"
         }
-        cpu_idle          = true
+        cpu_idle          = true # Set to false when using workflow
         startup_cpu_boost = true
       }