dockerfile.dev.example

# Category: Dev
# Service: NodeJS Development Dockerfile
# Description: Development environment for Next.js with volume mounting and hot reloading.
# Maintainer: ryumada

# STAGE 0: Base image with system dependencies (Cached)
FROM node:${DOCKER_NODEJS_TAG} AS base
RUN apk add --no-cache libc6-compat python3 make g++ shadow

# STAGE 1: Development environment
FROM base AS dev
# Add user and group with matching IDs from the host to fix permissions
ARG HOST_USER_ID
ARG HOST_GROUP_ID
RUN groupmod -g ${HOST_GROUP_ID} node
RUN usermod -u ${HOST_USER_ID} node

USER node
WORKDIR /usr/src/app

# Hardening: Disable Next.js telemetry
ENV NEXT_TELEMETRY_DISABLED=1

# Copy package files first to leverage Docker cache
COPY --chown=node:node app/${APP_NAME}/package.json app/${APP_NAME}/package-lock.json ./
RUN npm ci

# Copy application source code
COPY --chown=node:node app/${APP_NAME} ./

# Expose port for Next.js dev server
EXPOSE 3000

# Start the development server
CMD ["npm", "run", "dev"]