create-ej-app 17.0.0 → 18.0.0

package/README.md

@@ -1,6 +1,6 @@
 # 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, OTEL, and deployment wired up so you don’t screw your shit up in production.
+A no-bullshit CLI to bootstrap production-ready **fucking beasts** of apps with Next.js, Better Auth, Drizzle ORM, Elysia, Workflow, shadcn/ui, React Email, OTEL, and deployment wired up so you don’t screw your shit up in production.
 
 ```bash
 bunx create-ej-app@latest
@@ -49,6 +49,20 @@ bunx create-ej-app@latest
 
 ---
 
+## 📋 Templates (Pick your poison)
+
+Choose your template based on what you’re building:
+
+### Next.js Full-Stack App
+
+Full-stack setup with Next.js 16, Better Auth, shadcn/ui, and Drizzle ORM. Perfect for web apps that need auth, UI, and backend APIs.
+
+### API Server
+
+Production-ready REST API built with Elysia on Bun, Drizzle ORM, PostgreSQL, and Zod validation. Perfect for headless APIs, microservices, internal tools, or that backend you actually want to scale without it exploding like fragile shit.
+
+---
+
 ## 🚀 Quick Start (Let’s fucking go)
 
 ```bash
@@ -59,7 +73,7 @@ You’ll be prompted for:
 
 - Project name
 - Description
-- Template
+- Template (nextjs or api)
 - Git init (because not using git in 2026 is wild)
 
 Example:
@@ -67,7 +81,7 @@ Example:
 ```bash
 ? Enter the project name: badass-app
 ? Enter a description: My savage Next.js monster
-? Select a template: base
+? Select a template: nextjs
 ? Initialize a git repository? yes
 ```
 
@@ -77,7 +91,9 @@ Boom. Done.
 
 ## 📦 What You Actually Get
 
-### Tech Stack (The real weapons)
+### Next.js Full-Stack Template
+
+**Tech Stack (The real weapons)**
 
 - **Framework**: Next.js
 - **Runtime**: Bun (fast as shit)
@@ -93,6 +109,20 @@ Boom. Done.
 - **Forms**: react-hook-form + Zod
 - **Theme**: Dark mode out of the box
 
+### API Server Template
+
+**Tech Stack (The real weapons)**
+
+- **Runtime**: Bun (blazing fast as fuck)
+- **Framework**: Elysia
+- **Database**: PostgreSQL + Drizzle ORM
+- **Validation**: Zod v4
+- **API Docs**: Auto-generated OpenAPI docs
+- **Containerisation**: Docker with distroless images
+- **Type Checking**: TypeScript with strict mode
+- **Formatting**: Prettier
+- **Environment**: Validated env vars with @t3-oss/env-core
+
 ---
 
 ## 🛠 Setup & Development
@@ -101,8 +131,8 @@ Boom. Done.
 
 - Node 24+ or Bun
 - PostgreSQL running
-- OAuth creds if you want GitHub/Google login
-- Email provider (Resend, SES, Postmark, etc.)
+- OAuth creds if you want GitHub/Google login (Next.js template)
+- Email provider (Resend, SES, Postmark, etc.) (Next.js template)
 
 ### Install
 
@@ -124,26 +154,38 @@ Don’t commit this crap. Seriously.
 
 ## 💻 Development
 
+### Next.js Template
+
 ```bash
 bun run dev
 ```
 
 Open `http://localhost:3000` and admire your badass setup.
 
+### API Template
+
+```bash
+bun run dev
+```
+
+API runs on `http://localhost:3000`. OpenAPI docs at `http://localhost:3000/docs`.
+
+Fire it up, hit the endpoints, break things on purpose, and watch it handle your shit properly.
+
 ---
 
 ## 🐳 Docker (Ship it like a pro)
 
 ```bash
-docker build -t my-app .
-docker run -p 3000:3000 my-app
+bun run build:docker
+docker run -p 3000:3000 my-awesome-project
 ```
 
-No “works on my machine” bullshit anymore.
+No "works on my machine" bullshit anymore.
 
 ---
 
-## ☁️ Infrastructure (The Cloud Shit)
+## ☁️ Infrastructure (The Cloud Shit) - Next.js Template
 
 Terraform config included for:
 
@@ -167,7 +209,7 @@ And now you’re running production infra like a grown-ass engineer.
 
 ---
 
-## 🔐 Authentication
+## 🔐 Authentication - Next.js Template
 
 Better Auth gives you:
 
@@ -181,7 +223,7 @@ Secure, extensible, no duct-taped auth spaghetti.
 
 ---
 
-## 🎨 UI Components
+## 🎨 UI Components - Next.js Template
 
 Preinstalled:
 
@@ -201,7 +243,7 @@ Ship beautiful shit without reinventing buttons for the 900th time.
 
 ---
 
-## 🎯 Route Groups
+## 🎯 Route Groups - Next.js Template
 
 Organized like a sane human:
 
@@ -216,6 +258,8 @@ No messy folder hell.
 
 ## 🔧 Customization
 
+### Next.js Template
+
 Edit:
 
 - `siteConfig.ts` – change name/description
@@ -224,6 +268,38 @@ Edit:
 
 Then push schema and move on with your life.
 
+### API Template
+
+Edit:
+
+- `src/db/schema.ts` – change DB schema and model your data like a boss
+- `src/routes/` – add new API endpoints and wire your logic properly
+- `src/env.ts` – add new env vars and validate that shit
+
+Push schema with `bun run db:push` and type-check with `bun run type-check`.
+
+---
+
+## 🏗️ API Template Architecture
+
+Built with a clean layered architecture (no spaghetti garbage):
+
+- **Routes** (`src/routes/`) – HTTP endpoints, validation, call data-access. Keep it sharp.
+- **Data-Access** (`src/data-access/`) – Direct DB interactions per resource. No random queries scattered like WTF.
+- **Database** (`src/db/`) – Drizzle client, schemas, reusable fields. Your source of truth.
+- **Library** (`src/lib/`) – Shared utilities and Zod schemas so you don’t duplicate crap everywhere.
+
+Includes a full CRUD API for todos with pagination, sorting, search, and OpenAPI docs so you can see your shit documented without extra effort.
+
+### API Commands
+
+- `bun run dev` – Start dev server with hot-reload
+- `bun run build` – Type-check and compile to native binary
+- `bun run type-check` – Run TypeScript checker
+- `bun run db:push` – Push schema to DB
+- `bun run db:studio` – Open Drizzle Studio
+- `bun run db:seed` – Seed database
+
 ---
 
 ## 🤝 Contributing

package/cli.js

@@ -62,13 +62,13 @@ commander_1.program.action(() => __awaiter(void 0, void 0, void 0, function* ()
             type: 'input',
             name: 'projectName',
             message: 'Enter the project name:',
-            initial: 'my-app'
+            initial: 'my-project'
         },
         {
             type: 'input',
             name: 'description',
             message: 'Enter a description for the project:',
-            initial: 'A Legendary Next.js App'
+            initial: 'A Legendary Project'
         },
         {
             type: 'select',
@@ -76,8 +76,12 @@ commander_1.program.action(() => __awaiter(void 0, void 0, void 0, function* ()
             message: 'Select a template:',
             choices: [
                 {
-                    name: 'base',
-                    message: 'Base setup with Next 16, Better Auth, shadcn and Drizzle'
+                    name: 'nextjs',
+                    message: 'Full Stack setup with Next 16, Better Auth, shadcn and Drizzle'
+                },
+                {
+                    name: 'api',
+                    message: 'API Server setup with Elysia, Drizzle, Typescript'
                 }
             ]
         },
@@ -102,27 +106,36 @@ commander_1.program.action(() => __awaiter(void 0, void 0, void 0, function* ()
     packageJson.name = projectName;
     packageJson.description = description;
     fs_1.default.writeFileSync(packageJsonFile, JSON.stringify(packageJson, null, 2));
-    const siteConfigFile = path_1.default.join(projectDir, 'src', 'lib', 'siteConfig.ts');
-    let siteConfig = fs_1.default.readFileSync(siteConfigFile, 'utf-8');
-    siteConfig = siteConfig.replace('Project Name', projectName);
-    siteConfig = siteConfig.replace('Project Description', description);
-    fs_1.default.writeFileSync(siteConfigFile, siteConfig);
     const envExampleFile = path_1.default.join(projectDir, '.env.example');
     const envExample = fs_1.default.readFileSync(envExampleFile, 'utf-8');
     fs_1.default.writeFileSync(path_1.default.join(projectDir, '.env'), envExample);
-    fs_1.default.writeFileSync(path_1.default.join(projectDir, '.gitignore'), `node_modules
-.next
-out
-build
-next-env.d.ts
+    if (template === 'nextjs') {
+        const siteConfigFile = path_1.default.join(projectDir, 'src', 'lib', 'siteConfig.ts');
+        let siteConfig = fs_1.default.readFileSync(siteConfigFile, 'utf-8');
+        siteConfig = siteConfig.replace('Project Name', projectName);
+        siteConfig = siteConfig.replace('Project Description', description);
+        fs_1.default.writeFileSync(siteConfigFile, siteConfig);
+        fs_1.default.writeFileSync(path_1.default.join(projectDir, '.gitignore'), `node_modules
+  .next
+  out
+  build
+  next-env.d.ts
+  .DS_Store
+  .env
+`);
+        fs_1.default.writeFileSync(path_1.default.join(projectDir, 'terraform', '.gitignore'), `.terraform
+  *.tfstate
+  *.tfstate.*
+  .terraform.lock.hcl
+`);
+    }
+    if (template === 'api') {
+        fs_1.default.writeFileSync(path_1.default.join(projectDir, '.gitignore'), `node_modules
 .DS_Store
 .env
+server
 `);
-    fs_1.default.writeFileSync(path_1.default.join(projectDir, 'terraform', '.gitignore'), `.terraform
-*.tfstate
-*.tfstate.*
-.terraform.lock.hcl
-`);
+    }
     fs_1.default.writeFileSync(path_1.default.join(projectDir, 'README.md'), `# ${projectName}
 
 ${description}

package/cli.ts

@@ -59,13 +59,13 @@ program.action(async () => {
       type: 'input',
       name: 'projectName',
       message: 'Enter the project name:',
-      initial: 'my-app'
+      initial: 'my-project'
     },
     {
       type: 'input',
       name: 'description',
       message: 'Enter a description for the project:',
-      initial: 'A Legendary Next.js App'
+      initial: 'A Legendary Project'
     },
     {
       type: 'select',
@@ -73,8 +73,13 @@ program.action(async () => {
       message: 'Select a template:',
       choices: [
         {
-          name: 'base',
-          message: 'Base setup with Next 16, Better Auth, shadcn and Drizzle'
+          name: 'nextjs',
+          message:
+            'Full Stack setup with Next 16, Better Auth, shadcn and Drizzle'
+        },
+        {
+          name: 'api',
+          message: 'API Server setup with Elysia, Drizzle, Typescript'
         }
       ]
     },
@@ -106,36 +111,49 @@ program.action(async () => {
   packageJson.description = description
   fs.writeFileSync(packageJsonFile, JSON.stringify(packageJson, null, 2))
 
-  const siteConfigFile = path.join(projectDir, 'src', 'lib', 'siteConfig.ts')
-  let siteConfig = fs.readFileSync(siteConfigFile, 'utf-8')
-  siteConfig = siteConfig.replace('Project Name', projectName)
-  siteConfig = siteConfig.replace('Project Description', description)
-  fs.writeFileSync(siteConfigFile, siteConfig)
-
   const envExampleFile = path.join(projectDir, '.env.example')
   const envExample = fs.readFileSync(envExampleFile, 'utf-8')
   fs.writeFileSync(path.join(projectDir, '.env'), envExample)
 
-  fs.writeFileSync(
-    path.join(projectDir, '.gitignore'),
-    `node_modules
-.next
-out
-build
-next-env.d.ts
-.DS_Store
-.env
+  if (template === 'nextjs') {
+    const siteConfigFile = path.join(projectDir, 'src', 'lib', 'siteConfig.ts')
+    let siteConfig = fs.readFileSync(siteConfigFile, 'utf-8')
+    siteConfig = siteConfig.replace('Project Name', projectName)
+    siteConfig = siteConfig.replace('Project Description', description)
+    fs.writeFileSync(siteConfigFile, siteConfig)
+
+    fs.writeFileSync(
+      path.join(projectDir, '.gitignore'),
+      `node_modules
+  .next
+  out
+  build
+  next-env.d.ts
+  .DS_Store
+  .env
 `
-  )
+    )
+
+    fs.writeFileSync(
+      path.join(projectDir, 'terraform', '.gitignore'),
+      `.terraform
+  *.tfstate
+  *.tfstate.*
+  .terraform.lock.hcl
+`
+    )
+  }
 
-  fs.writeFileSync(
-    path.join(projectDir, 'terraform', '.gitignore'),
-    `.terraform
-*.tfstate
-*.tfstate.*
-.terraform.lock.hcl
+  if (template === 'api') {
+    fs.writeFileSync(
+      path.join(projectDir, '.gitignore'),
+      `node_modules
+.DS_Store
+.env
+server
 `
-  )
+    )
+  }
 
   fs.writeFileSync(
     path.join(projectDir, 'README.md'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ej-app",
-  "version": "17.0.0",
+  "version": "18.0.0",
   "description": "Bootstrap a next.js app with my preferred setup",
   "main": "cli.js",
   "scripts": {
@@ -35,7 +35,7 @@
     "enquirer": "^2.4.1"
   },
   "devDependencies": {
-    "@types/node": "^25.2.3",
+    "@types/node": "^25.3.0",
     "typescript": "^5.9.3"
   }
 }

package/template/api/.env.example

@@ -0,0 +1,3 @@
+PORT="3000"
+APP_ENV="production"
+DATABASE_URL="postgresql://postgres:postgres@localhost:5432/postgres"

package/template/api/.github/copilot-instructions.md

@@ -0,0 +1,129 @@
+# Copilot Instructions
+
+## Project Overview
+
+This project is a production-ready REST API built with **Elysia** on the **Bun** runtime. It uses **Drizzle ORM** with **PostgreSQL**, **Zod v4** for validation, and ships with auto-generated OpenAPI docs.
+
+## Tech Stack
+
+- **Runtime:** Bun (not Node.js) — use `bun` for all CLI commands
+- **HTTP Framework:** Elysia
+- **Database:** PostgreSQL via Drizzle ORM (using the `bun-sql` driver)
+- **Validation:** Zod v4
+- **Environment Validation:** @t3-oss/env-core + Zod
+- **API Docs:** @elysiajs/openapi (served at `/docs`)
+- **Type Checker:** @typescript/native-preview (`tsgo`) — NOT `tsc`
+- **Formatter:** Prettier (with `prettier-plugin-organize-imports`)
+- **Containerisation:** Docker with multi-stage build producing a distroless image
+
+## Project Structure
+
+```
+src/
+├── index.ts              # App entry point – boots the Elysia server
+├── env.ts                # Validated env vars (Zod + t3-env)
+├── data-access/          # Database query functions (one file per resource)
+│   └── todo.ts
+├── db/
+│   ├── fields.ts         # Reusable Drizzle column definitions
+│   ├── index.ts          # Drizzle client singleton
+│   └── schema.ts         # All Drizzle table definitions
+├── lib/
+│   └── util.ts           # Shared Zod schemas (pagination, sorting)
+└── routes/
+    ├── index.ts           # Top-level /api router
+    └── todo/
+        └── index.ts       # CRUD routes for /api/todos
+```
+
+## Architecture & Conventions
+
+### Layered Architecture
+
+The project follows a strict separation of concerns:
+
+1. **Routes** (`src/routes/`) — Define HTTP endpoints, request/response validation, and call data-access functions. Route handlers never import `db` directly.
+2. **Data-Access** (`src/data-access/`) — All direct database interactions. One file per resource. Route handlers call these functions exclusively.
+3. **Database** (`src/db/`) — Drizzle client singleton, table schema definitions, and reusable column helpers.
+4. **Library** (`src/lib/`) — Shared utilities, reusable Zod schema fragments.
+
+### Adding a New Resource
+
+1. Create the Drizzle table in `src/db/schema.ts` (use `commonFieldDefs` from `src/db/fields.ts` for id, `createdAt`, `updatedAt`).
+2. Create `src/data-access/<resource>.ts` with all DB query functions.
+3. Create `src/routes/<resource>/index.ts` with the Elysia router.
+4. Register the new router in `src/routes/index.ts` via `.use()`.
+5. Push Schema changes with `bun run db:push`.
+6. Run `bun type-check` to ensure types are correct across layers.
+
+### Route Conventions
+
+- All API routes live under the `/api` prefix.
+- Each resource router uses `new Elysia({ prefix: '/<resource>' })`.
+- Every route handler validates input using Zod schemas in the third argument to route methods (`query`, `params`, `body`).
+- UUID path params are validated with `z.uuid()`.
+- Each route includes a `detail` object with `description` and `tags` for OpenAPI documentation.
+- Handlers use try/catch, returning `{ success: true, data: { ... } }` on success and `status(statusCode, { success: false, error: '...' })` on failure.
+- Use `status()` from `elysia` (not `.set.status`) for error responses.
+
+### Database & Schema Conventions
+
+- All tables use **UUID** primary keys generated by the database (`defaultRandom()`).
+- All tables include `created_at` and `updated_at` timestamp columns via the `commonFieldDefs.dates` spread.
+- Use `commonFieldDefs.id` for the primary key column.
+- The Drizzle client is a singleton exported from `src/db/index.ts`.
+- Column names in the database use **snake_case** (`created_at`), while TypeScript properties use **camelCase** (`createdAt`).
+- Schema definitions are in `src/db/schema.ts` — the single source of truth shared by both the app and Drizzle Kit.
+
+### Validation & Environment
+
+- Zod v4 is used for all request validation (NOT Elysia's built-in typebox schemas).
+- Environment variables are validated at startup via `src/env.ts`. If a variable is missing or invalid the app refuses to start.
+- Import env as `import { env } from '~/env'`.
+
+### Path Aliases
+
+- `~/*` maps to `./src/*` (configured in `tsconfig.json`). Always use `~/` imports for project files.
+
+### Code Style
+
+- **No semicolons** — the project uses Prettier with `semi: false`.
+- **Single quotes** for strings.
+- **No trailing commas** (`trailingComma: 'none'`).
+- **Arrow parens:** avoid when possible (`arrowParens: 'avoid'`).
+- **Tab width:** 2 spaces.
+- Imports are auto-organised by `prettier-plugin-organize-imports`.
+- Use `const` arrow functions for exported functions (not `function` declarations).
+- Add JSDoc comments on all exports describing their purpose.
+
+### TypeScript
+
+- Strict mode is enabled with all strict checks (`noImplicitAny`, `strictNullChecks`, `noUnusedLocals`, `noUnusedParameters`, `noImplicitReturns`, `noUncheckedIndexedAccess`, etc.).
+- Target is `ESNext` with `module: ESNext` and `moduleResolution: bundler`.
+- Type checking is done with `tsgo` (`bun run type-check`), not `tsc`.
+
+### Pagination & Sorting
+
+- Use the `paginationSchema` spread from `src/lib/util.ts` for paginated list endpoints (offset-based, 1-indexed pages, default limit 10, max 100).
+- Use `getSortSchema(['field1', 'field2', ...])` for sortable endpoints.
+- List responses follow the shape: `{ success, data: { page, limit, hasMore, <items>, count } }`.
+
+### Error Handling
+
+- Route handlers wrap logic in try/catch.
+- Log errors with `console.error('Error in METHOD /path', err)`.
+- Return `status(500, { success: false, error: 'Something went wrong.' })` for unexpected errors.
+- Return `status(404, { success: false, error: '<Resource> not found' })` for missing resources.
+
+## Commands
+
+| Command                | Purpose                               |
+| ---------------------- | ------------------------------------- |
+| `bun dev`              | Start dev server with hot-reload      |
+| `bun run build`        | Type-check + compile to native binary |
+| `bun run type-check`   | Run tsgo type checker                 |
+| `bun run format`       | Format code with Prettier             |
+| `bun run db:push`      | Push Drizzle schema to the database   |
+| `bun run db:studio`    | Open Drizzle Studio                   |
+| `bun run db:seed`      | Run seed script                       |
+| `bun run build:docker` | Build Docker image                    |

package/template/api/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  "recommendations": [
+    "eamodio.gitlens",
+    "esbenp.prettier-vscode",
+    "TypeScriptTeam.native-preview",
+    "usernamehw.errorlens",
+    "YoavBls.pretty-ts-errors"
+  ]
+}

package/template/api/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "typescript.experimental.useTsgo": true
+}

package/template/api/Dockerfile

@@ -0,0 +1,23 @@
+FROM oven/bun:latest AS build
+
+WORKDIR /app
+
+COPY package.json bun.lock ./
+
+RUN bun install --frozen-lockfile
+
+COPY . .
+
+ENV NODE_ENV=production
+
+RUN bun run build
+
+FROM gcr.io/distroless/base
+
+WORKDIR /app
+
+COPY --from=build /app/server server
+
+ENV NODE_ENV=production
+
+ENTRYPOINT ["./server"]

package/template/api/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "my-api",
+  "version": "1.0.0",
+  "private": true,
+  "main": "src/index.ts",
+  "scripts": {
+    "dev": "bun --watch .",
+    "build": "bun type-check && bun build --compile --target bun --outfile server .",
+    "build:docker": "docker build -t my-api .",
+    "type-check": "tsgo --incremental false",
+    "format": "prettier --write \"./src/**/*.{js,cjs,mjs,jsx,ts,tsx}\"",
+    "db:push": "drizzle-kit push",
+    "db:studio": "drizzle-kit studio",
+    "db:seed": "bun ./src/scripts/seed.ts"
+  },
+  "dependencies": {
+    "@elysiajs/openapi": "1.4.14",
+    "@t3-oss/env-core": "0.13.10",
+    "drizzle-orm": "0.45.1",
+    "elysia": "1.4.25",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.9",
+    "@typescript/native-preview": "7.0.0-dev.20260217.1",
+    "drizzle-kit": "0.31.9",
+    "postgres": "3.4.8",
+    "prettier": "3.8.1",
+    "prettier-plugin-organize-imports": "4.3.0"
+  }
+}

package/template/api/prettier.config.mjs

@@ -0,0 +1,11 @@
+/** @type {import('prettier').Config} */
+const config = {
+  plugins: ['prettier-plugin-organize-imports'],
+  arrowParens: 'avoid',
+  trailingComma: 'none',
+  semi: false,
+  singleQuote: true,
+  tabWidth: 2
+}
+
+export default config