bunjs-production

Bun.js Production Deployment Patterns

Overview

This skill covers production deployment patterns for Bun.js TypeScript backend applications, including Docker containerization, AWS ECS deployment, Redis caching, security hardening, structured logging, CI/CD pipelines, and production readiness checklists.

When to use this skill:

• Containerizing applications with Docker
• Deploying to AWS ECS/Fargate
• Implementing Redis caching strategies
• Hardening security (headers, CORS, rate limiting)
• Setting up CI/CD pipelines
• Preparing for production deployment

See also:

• ${CLAUDE_PLUGIN_ROOT}/knowledge/backend/bunjs.md - Core Bun patterns, HTTP servers, database access
• ${CLAUDE_PLUGIN_ROOT}/skills/backend/bunjs-architecture/SKILL.md - Layered architecture, camelCase conventions
• ${CLAUDE_PLUGIN_ROOT}/knowledge/backend/bunjs-apidog.md - OpenAPI specifications and Apidog integration

Docker Multi-Stage Build

Production Dockerfile

# Stage 1: Base
FROM oven/bun:1-alpine AS base
WORKDIR /app

# Stage 2: Dependencies
FROM base AS deps
COPY package.json bun.lockb ./
COPY prisma ./prisma/
RUN bun install --frozen-lockfile --production

# Stage 3: Build
FROM base AS build
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN bunx prisma generate
RUN bun run build  # Optional: if you have a build step

# Stage 4: Runner
FROM base AS runner
WORKDIR /app
ENV NODE_ENV=production

# Create non-root user
RUN addgroup -g 1001 bungroup && \
    adduser -D -u 1001 -G bungroup bunuser

# Copy dependencies and source
COPY --from=deps /app/node_modules ./node_modules
COPY --from=build /app/src ./src
COPY --from=build /app/prisma ./prisma
COPY --from=build /app/node_modules/.prisma ./node_modules/.prisma
COPY package.json bun.lockb ./

# Set ownership
RUN chown -R bunuser:bungroup /app

USER bunuser
EXPOSE 3000

# Health check
HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --retries=3 \
  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1

CMD ["bun", "src/server.ts"]