create-turbo-mono 1.0.0

package/src/templates/docker.ts

@@ -0,0 +1,503 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { ProjectConfig } from '../scaffold';
+
+export async function createDockerFiles(config: ProjectConfig): Promise<void> {
+  const { targetDir, backends, frontends } = config;
+
+  await createDockerfileBase(targetDir, backends, frontends);
+  await createDockerComposeLocal(targetDir);
+  await createDockerComposeDev(targetDir, backends, frontends);
+  await createDockerComposeProd(targetDir, backends, frontends);
+  await createDockerIgnore(targetDir);
+}
+
+async function createDockerfileBase(
+  targetDir: string,
+  backends: string[],
+  frontends: string[]
+): Promise<void> {
+  const backendTargets = backends
+    .map(
+      (name) => `# ============================================
+# ${name.toUpperCase()} Production
+# ============================================
+FROM build-base AS ${name}-production
+WORKDIR /app/apps/backend/${name}
+
+ENV NODE_OPTIONS="--max-old-space-size=4096"
+
+RUN --mount=type=cache,id=nest,target=/app/node_modules/.cache \\
+    echo "📦 Building ${name}..." && \\
+    pnpm prisma generate && \\
+    pnpm run build
+
+ENV NODE_OPTIONS="--max-old-space-size=2048"
+
+EXPOSE 3000
+
+CMD ["sh", "-c", "pnpm prisma generate && until pnpm prisma migrate deploy; do echo 'Waiting for DB...'; sleep 2; done && pnpm run start:prod"]
+
+# ============================================
+# ${name.toUpperCase()} Development
+# ============================================
+FROM shared-libs AS ${name}-development
+WORKDIR /app/apps/backend/${name}
+ENV NODE_ENV=development
+
+EXPOSE 3000
+CMD ["sh", "-c", "pnpm prisma generate && until pnpm prisma migrate deploy; do echo 'Waiting for DB...'; sleep 2; done && pnpm run dev"]`
+    )
+    .join('\n\n');
+
+  const frontendTargets = frontends
+    .map(
+      (name, index) => `# ============================================
+# ${name.toUpperCase()} Production
+# ============================================
+FROM build-base AS ${name}-production
+WORKDIR /app/apps/frontend/${name}
+
+ENV NODE_OPTIONS="--max-old-space-size=4096"
+
+RUN --mount=type=cache,id=next,target=/app/node_modules/.cache \\
+    echo "🌐 Building ${name}..." && \\
+    NEXT_TELEMETRY_DISABLED=1 pnpm next build
+
+ENV NODE_OPTIONS="--max-old-space-size=2048"
+
+EXPOSE ${3000 + index}
+CMD ["pnpm", "run", "start"]`
+    )
+    .join('\n\n');
+
+  const dockerfile = `# syntax=docker/dockerfile:1
+
+# ============================================
+# Global Build Arguments
+# ============================================
+ARG NODE_VERSION=20
+ARG DATABASE_URL
+
+# ============================================
+# Base Stage – Node + pnpm + Workspace setup
+# ============================================
+FROM node:\${NODE_VERSION}-alpine AS base
+
+# Install pnpm
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+# Essentials
+RUN apk add --no-cache curl bash postgresql-client
+
+WORKDIR /app
+
+# Workspace files
+COPY package.json pnpm-workspace.yaml pnpm-lock.yaml ./
+COPY turbo.json tsconfig.json ./
+COPY packages/ packages/
+
+# App-level package.json
+${backends.map((name) => `COPY apps/backend/${name}/package.json apps/backend/${name}/`).join('\n')}
+${frontends.map((name) => `COPY apps/frontend/${name}/package.json apps/frontend/${name}/`).join('\n')}
+
+# ============================================
+# Dependencies Stage
+# ============================================
+FROM base AS dependencies
+
+RUN --mount=type=cache,id=pnpm,target=/root/.local/share/pnpm/store \\
+    pnpm install --frozen-lockfile
+
+# ============================================
+# Shared Libraries + Prisma Clients
+# ============================================
+FROM dependencies AS shared-libs
+
+ARG DATABASE_URL
+ENV DATABASE_URL=\${DATABASE_URL}
+
+# Prisma schema
+COPY packages/database/prisma/ packages/database/prisma/
+
+# Generate Prisma client
+RUN echo "🧩 Generating Prisma client..." && \\
+    cd packages/database && pnpm prisma generate
+
+# Build shared packages
+RUN --mount=type=cache,id=turbo,target=/app/node_modules/.cache \\
+    pnpm turbo run build --filter="@repo/shared-*"
+
+# ============================================
+# Common Build Base
+# ============================================
+FROM shared-libs AS build-base
+
+# Source
+COPY apps/ apps/
+
+ENV NODE_ENV=production
+ENV NEXT_TELEMETRY_DISABLED=1
+
+${backendTargets}
+
+${frontendTargets}
+`;
+
+  await fs.writeFile(path.join(targetDir, 'Dockerfile'), dockerfile);
+}
+
+async function createDockerComposeLocal(targetDir: string): Promise<void> {
+  const dockerComposeLocal = `version: '3.8'
+
+services:
+  # PostgreSQL Database
+  postgres:
+    image: postgres:15-alpine
+    container_name: \${PROJECT_NAME:-app}-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: \${DATABASE_USER:-postgres}
+      POSTGRES_PASSWORD: \${DATABASE_PASSWORD:-postgres}
+      POSTGRES_DB: \${DATABASE_NAME:-app_db}
+    ports:
+      - '\${DATABASE_PORT:-5432}:5432'
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U \${DATABASE_USER:-postgres}']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - app-network
+
+  # Redis Cache
+  redis:
+    image: redis:7-alpine
+    container_name: \${PROJECT_NAME:-app}-redis
+    restart: unless-stopped
+    ports:
+      - '\${REDIS_PORT:-6379}:6379'
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - app-network
+
+networks:
+  app-network:
+    driver: bridge
+
+volumes:
+  postgres_data:
+    name: \${PROJECT_NAME:-app}-postgres-data
+  redis_data:
+    name: \${PROJECT_NAME:-app}-redis-data
+`;
+
+  await fs.writeFile(
+    path.join(targetDir, 'docker-compose.local.yml'),
+    dockerComposeLocal
+  );
+}
+
+async function createDockerComposeDev(
+  targetDir: string,
+  backends: string[],
+  frontends: string[]
+): Promise<void> {
+  const backendServices = backends
+    .map(
+      (name, index) => `  # ${name} Backend
+  ${name}:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: ${name}-development
+    container_name: \${PROJECT_NAME:-app}-${name}
+    restart: unless-stopped
+    env_file: .env
+    environment:
+      NODE_ENV: development
+      DATABASE_URL: postgresql://\${DATABASE_USER:-postgres}:\${DATABASE_PASSWORD:-postgres}@postgres:5432/\${DATABASE_NAME:-app_db}
+      REDIS_URL: redis://redis:6379
+    volumes:
+      - ./apps/backend/${name}:/app/apps/backend/${name}
+      - ./packages:/app/packages
+      - /app/node_modules
+      - /app/apps/backend/${name}/node_modules
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    ports:
+      - '\${${name.toUpperCase()}_PORT:-${4000 + index}}:3000'
+    networks:
+      - app-network`
+    )
+    .join('\n\n');
+
+  const frontendServices = frontends
+    .map(
+      (name, index) => `  # ${name} Frontend
+  ${name}:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: ${name}-production
+    container_name: \${PROJECT_NAME:-app}-${name}
+    restart: unless-stopped
+    env_file: .env
+    environment:
+      NODE_ENV: development
+      NEXT_PUBLIC_API_URL: \${NEXT_PUBLIC_API_URL:-http://localhost:4000}
+    volumes:
+      - ./apps/frontend/${name}:/app/apps/frontend/${name}
+      - ./packages:/app/packages
+      - /app/node_modules
+      - /app/apps/frontend/${name}/node_modules
+      - /app/apps/frontend/${name}/.next
+    ports:
+      - '\${${name.toUpperCase()}_PORT:-${3000 + index}}:${3000 + index}'
+    networks:
+      - app-network`
+    )
+    .join('\n\n');
+
+  const dockerComposeDev = `version: '3.8'
+
+services:
+  # PostgreSQL Database
+  postgres:
+    image: postgres:15-alpine
+    container_name: \${PROJECT_NAME:-app}-postgres-dev
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: \${DATABASE_USER:-postgres}
+      POSTGRES_PASSWORD: \${DATABASE_PASSWORD:-postgres}
+      POSTGRES_DB: \${DATABASE_NAME:-app_db}
+    ports:
+      - '\${DATABASE_PORT:-5432}:5432'
+    volumes:
+      - postgres_dev_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U \${DATABASE_USER:-postgres}']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - app-network
+
+  # Redis Cache
+  redis:
+    image: redis:7-alpine
+    container_name: \${PROJECT_NAME:-app}-redis-dev
+    restart: unless-stopped
+    ports:
+      - '\${REDIS_PORT:-6379}:6379'
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - app-network
+
+${backendServices}
+
+${frontendServices}
+
+networks:
+  app-network:
+    driver: bridge
+
+volumes:
+  postgres_dev_data:
+    name: \${PROJECT_NAME:-app}-postgres-dev-data
+  redis_dev_data:
+    name: \${PROJECT_NAME:-app}-redis-dev-data
+`;
+
+  await fs.writeFile(
+    path.join(targetDir, 'docker-compose.dev.yml'),
+    dockerComposeDev
+  );
+}
+
+async function createDockerComposeProd(
+  targetDir: string,
+  backends: string[],
+  frontends: string[]
+): Promise<void> {
+  const backendServices = backends
+    .map(
+      (name, index) => `  # ${name} Backend
+  ${name}:
+    image: ghcr.io/\${GITHUB_REPOSITORY:-your-org/your-repo}/${name}:\${RELEASE_TAG:-latest}
+    container_name: \${PROJECT_NAME:-app}-${name}
+    restart: unless-stopped
+    env_file: .env
+    environment:
+      NODE_ENV: production
+      DATABASE_URL: postgresql://\${DATABASE_USER:-postgres}:\${DATABASE_PASSWORD:-postgres}@postgres:5432/\${DATABASE_NAME:-app_db}
+      REDIS_URL: redis://redis:6379
+      PORT: 3000
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    ports:
+      - '\${${name.toUpperCase()}_PORT:-${4000 + index}}:3000'
+    healthcheck:
+      test: ['CMD-SHELL', 'wget -qO- http://127.0.0.1:3000/health || exit 1']
+      interval: 15s
+      timeout: 5s
+      retries: 10
+      start_period: 90s
+    networks:
+      - app-network`
+    )
+    .join('\n\n');
+
+  const frontendServices = frontends
+    .map(
+      (name, index) => `  # ${name} Frontend
+  ${name}:
+    image: ghcr.io/\${GITHUB_REPOSITORY:-your-org/your-repo}/${name}:\${RELEASE_TAG:-latest}
+    container_name: \${PROJECT_NAME:-app}-${name}
+    restart: unless-stopped
+    env_file: .env
+    environment:
+      NODE_ENV: production
+      HOST: 0.0.0.0
+      PORT: ${3000 + index}
+      NEXT_PUBLIC_API_URL: \${NEXT_PUBLIC_API_URL:-http://localhost:4000}
+    ports:
+      - '\${${name.toUpperCase()}_PORT:-${3000 + index}}:${3000 + index}'
+    healthcheck:
+      test: ['CMD-SHELL', 'wget -qO- http://127.0.0.1:${3000 + index}/ || exit 1']
+      interval: 20s
+      timeout: 5s
+      retries: 6
+      start_period: 60s
+    networks:
+      - app-network`
+    )
+    .join('\n\n');
+
+  const dockerComposeProd = `name: \${PROJECT_NAME:-app}-deploy
+
+services:
+  # PostgreSQL Database
+  postgres:
+    image: postgres:15-alpine
+    restart: unless-stopped
+    env_file: .env
+    environment:
+      POSTGRES_USER: \${DATABASE_USER:-postgres}
+      POSTGRES_PASSWORD: \${DATABASE_PASSWORD:-postgres}
+      POSTGRES_DB: \${DATABASE_NAME:-app_db}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U \${DATABASE_USER:-postgres} -d \${DATABASE_NAME:-app_db}']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - app-network
+
+  # Redis Cache
+  redis:
+    image: redis:7-alpine
+    restart: unless-stopped
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - app-network
+
+${backendServices}
+
+${frontendServices}
+
+networks:
+  app-network:
+    driver: bridge
+
+volumes:
+  postgres_data:
+    external: true
+    name: \${PROJECT_NAME:-app}-postgres-prod-data
+  redis_data:
+    name: \${PROJECT_NAME:-app}-redis-prod-data
+`;
+
+  await fs.writeFile(
+    path.join(targetDir, 'docker-compose.prod.yml'),
+    dockerComposeProd
+  );
+}
+
+async function createDockerIgnore(targetDir: string): Promise<void> {
+  const dockerignore = `# Dependencies
+node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Build outputs
+dist
+.next
+out
+build
+*.tsbuildinfo
+
+# Testing
+coverage
+.nyc_output
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Misc
+.DS_Store
+*.pem
+.vscode
+.idea
+
+# Git
+.git
+.gitignore
+
+# Docker
+Dockerfile*
+docker-compose*.yml
+.dockerignore
+
+# Documentation
+*.md
+!README.md
+
+# CI/CD
+.github
+.gitlab-ci.yml
+
+# Turborepo
+.turbo
+`;
+
+  await fs.writeFile(path.join(targetDir, '.dockerignore'), dockerignore);
+}

package/src/templates/docs.ts

@@ -0,0 +1,74 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { ProjectConfig } from '../scaffold';
+
+export async function createDocumentation(config: ProjectConfig): Promise<void> {
+  const { targetDir, backends, frontends } = config;
+  const docsDir = path.join(targetDir, 'docs');
+
+  await fs.ensureDir(docsDir);
+
+  await createEnvGuide(docsDir, backends, frontends);
+}
+
+async function createEnvGuide(
+  docsDir: string,
+  backends: string[],
+  frontends: string[]
+): Promise<void> {
+  const content = `# Environment Variables
+
+## Required
+
+\`\`\`bash
+# Database
+DATABASE_URL="postgresql://postgres:postgres@localhost:5432/app_db"
+
+# Redis
+REDIS_URL="redis://localhost:6379"
+\`\`\`
+
+## Optional
+
+\`\`\`bash
+# JWT
+JWT_SECRET="your-secret-key"
+JWT_EXPIRES_IN="7d"
+
+# CORS
+CORS_ORIGINS="http://localhost:3000"
+
+# Email (for CI/CD notifications)
+SMTP_SERVER=smtp.gmail.com
+SMTP_PORT=587
+SMTP_USERNAME=your-email@gmail.com
+SMTP_PASSWORD=your-app-password
+\`\`\`
+
+## Docker
+
+\`\`\`bash
+NODE_VERSION=20
+REGISTRY=ghcr.io
+IMAGE_TAG=latest
+\`\`\`
+
+## GitHub Actions Secrets
+
+| Secret | Description |
+|--------|-------------|
+| \`SSH_HOST\` | Server IP/domain |
+| \`SSH_USER\` | SSH username |
+| \`SSH_KEY\` | Private SSH key |
+| \`DEPLOY_PATH\` | Deployment directory |
+
+## Service Ports
+
+| Service | Port |
+|---------|------|
+${backends.map((name, i) => `| ${name} | ${4000 + i} |`).join('\n')}
+${frontends.map((name, i) => `| ${name} | ${3000 + i} |`).join('\n')}
+`;
+
+  await fs.writeFile(path.join(docsDir, 'ENVIRONMENT.md'), content);
+}