Add Prisma and PostgreSQL API template

Author: wbizmo

dist/templates/api/README.md

@@ -1,34 +1,40 @@
 # {{PROJECT_DISPLAY_NAME}}
 
-Production-oriented Fastify API starter generated with LaunchStack CLI.
+Production-oriented Fastify and PostgreSQL API starter generated with LaunchStack CLI.
 
 ## Included
 
 - Fastify server bootstrap
 - TypeScript
+- Prisma ORM
+- PostgreSQL
+- Docker Compose database service
 - Environment configuration
 - Structured logging
 - CORS support
-- Sensible HTTP utilities
-- Central error handler
-- Structured not-found responses
-- Health endpoint
+- Central error handling
+- Health endpoints
 - Graceful shutdown
 - Vitest integration tests
 
 ## Requirements
 
-Node.js 20 or newer.
+- Node.js 20 or newer
+- PostgreSQL or Docker
 
 ## Setup
 
 Install dependencies:
 
     npm install
 
-Create the environment file:
+Start PostgreSQL:
 
-    cp .env.example .env
+    npm run db:up
+
+Create the initial migration:
+
+    npm run prisma:migrate -- --name init
 
 Start development mode:
 
@@ -38,9 +44,32 @@ The API starts on:
 
     http://localhost:3000
 
-Health endpoint:
+Health endpoints:
 
     GET http://localhost:3000/health
+    GET http://localhost:3000/health/database
+
+## Database Commands
+
+Generate Prisma Client:
+
+    npm run prisma:generate
+
+Create a development migration:
+
+    npm run prisma:migrate
+
+Apply production migrations:
+
+    npm run prisma:deploy
+
+Open Prisma Studio:
+
+    npm run prisma:studio
+
+Stop PostgreSQL:
+
+    npm run db:down
 
 ## Quality Commands
 
@@ -52,7 +81,7 @@ Run type checking:
 
     npm run typecheck
 
-Build the project:
+Build:
 
     npm run build
 
@@ -62,24 +91,20 @@ Start the production build:
 
 ## Structure
 
+    prisma/
+      schema.prisma
     src/
       config/
-        env.ts
+      lib/
+        prisma.ts
       plugins/
-        config.ts
-        cors.ts
-        error-handler.ts
-        index.ts
-        sensible.ts
+        database.ts
       routes/
-        health.ts
-        index.ts
       types/
-        fastify.d.ts
       app.ts
       server.ts
     tests/
-      health.test.ts
+    docker-compose.yml
 
 ## Generated by
 

dist/templates/api/_env

@@ -0,0 +1,6 @@
+NODE_ENV=development
+HOST=0.0.0.0
+PORT=3000
+LOG_LEVEL=info
+CORS_ORIGIN=*
+DATABASE_URL=postgresql://launchstack:launchstack@localhost:5432/{{PROJECT_NAME}}?schema=public

dist/templates/api/_env.example

@@ -3,3 +3,4 @@ HOST=0.0.0.0
 PORT=3000
 LOG_LEVEL=info
 CORS_ORIGIN=*
+DATABASE_URL=postgresql://launchstack:launchstack@localhost:5432/{{PROJECT_NAME}}?schema=public

dist/templates/api/docker-compose.yml

@@ -0,0 +1,23 @@
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: {{PROJECT_NAME}}-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: launchstack
+      POSTGRES_PASSWORD: launchstack
+      POSTGRES_DB: {{PROJECT_NAME}}
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test:
+        - CMD-SHELL
+        - pg_isready -U launchstack -d {{PROJECT_NAME}}
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+volumes:
+  postgres_data:

dist/templates/api/package.json

@@ -5,19 +5,30 @@
   "description": "{{PROJECT_DISPLAY_NAME}} backend API generated with LaunchStack CLI.",
   "scripts": {
     "dev": "tsx watch src/server.ts",
-    "build": "tsc -p tsconfig.json",
+    "build": "prisma generate && tsc -p tsconfig.json",
     "start": "node dist/server.js",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "typecheck": "prisma generate && tsc --noEmit",
+    "test": "vitest run",
+    "postinstall": "prisma generate",
+    "prisma:generate": "prisma generate",
+    "prisma:migrate": "prisma migrate dev",
+    "prisma:deploy": "prisma migrate deploy",
+    "prisma:studio": "prisma studio",
+    "db:up": "docker compose up -d postgres",
+    "db:down": "docker compose down",
+    "db:logs": "docker compose logs -f postgres"
   },
   "dependencies": {
     "@fastify/cors": "^11.1.0",
     "@fastify/sensible": "^6.0.3",
+    "@prisma/client": "^6.0.0",
+    "dotenv": "^16.4.0",
     "fastify": "^5.6.1",
     "fastify-plugin": "^5.0.1"
   },
   "devDependencies": {
     "@types/node": "^25.0.0",
+    "prisma": "^6.0.0",
     "tsx": "^4.20.0",
     "typescript": "^6.0.0",
     "vitest": "^4.0.0"

dist/templates/api/prisma/schema.prisma

@@ -0,0 +1,18 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id        String   @id @default(cuid())
+  email     String   @unique
+  name      String?
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@map("users")
+}

dist/templates/api/src/config/env.ts

@@ -1,9 +1,12 @@
+import "dotenv/config";
+
 export type AppEnvironment = {
   nodeEnv: "development" | "test" | "production";
   host: string;
   port: number;
   logLevel: string;
   corsOrigin: string;
+  databaseUrl: string;
 };
 
 function parsePort(value: string | undefined): number {
@@ -34,12 +37,27 @@ function parseNodeEnvironment(
   return environment;
 }
 
+function requireEnvironmentVariable(
+  name: string,
+  value: string | undefined
+): string {
+  if (!value || !value.trim()) {
+    throw new Error(`${name} is required.`);
+  }
+
+  return value;
+}
+
 export function loadEnvironment(): AppEnvironment {
   return {
     nodeEnv: parseNodeEnvironment(process.env.NODE_ENV),
     host: process.env.HOST ?? "0.0.0.0",
     port: parsePort(process.env.PORT),
     logLevel: process.env.LOG_LEVEL ?? "info",
-    corsOrigin: process.env.CORS_ORIGIN ?? "*"
+    corsOrigin: process.env.CORS_ORIGIN ?? "*",
+    databaseUrl: requireEnvironmentVariable(
+      "DATABASE_URL",
+      process.env.DATABASE_URL
+    )
   };
 }

dist/templates/api/src/lib/prisma.ts

@@ -0,0 +1,18 @@
+import { PrismaClient } from "@prisma/client";
+
+declare global {
+  var launchStackPrisma: PrismaClient | undefined;
+}
+
+export const prisma =
+  globalThis.launchStackPrisma ??
+  new PrismaClient({
+    log:
+      process.env.NODE_ENV === "development"
+        ? ["warn", "error"]
+        : ["error"]
+  });
+
+if (process.env.NODE_ENV !== "production") {
+  globalThis.launchStackPrisma = prisma;
+}

dist/templates/api/src/plugins/database.ts

@@ -0,0 +1,16 @@
+import fp from "fastify-plugin";
+import { prisma } from "../lib/prisma";
+
+export const databasePlugin = fp(
+  async (app) => {
+    app.decorate("prisma", prisma);
+
+    app.addHook("onClose", async () => {
+      await prisma.$disconnect();
+    });
+  },
+  {
+    name: "database",
+    dependencies: ["config"]
+  }
+);

dist/templates/api/src/plugins/index.ts

@@ -1,13 +1,15 @@
 import type { FastifyInstance } from "fastify";
 import { configPlugin } from "./config";
 import { corsPlugin } from "./cors";
+import { databasePlugin } from "./database";
 import { errorHandlerPlugin } from "./error-handler";
 import { sensiblePlugin } from "./sensible";
 
 export async function registerPlugins(
   app: FastifyInstance
 ): Promise<void> {
   await app.register(configPlugin);
+  await app.register(databasePlugin);
   await app.register(sensiblePlugin);
   await app.register(corsPlugin);
   await app.register(errorHandlerPlugin);