Dockerfile

# Multistage build to prevent code exposure / reduce image size

# ======================== BUILD IMAGE ========================
# Uses deps and env vars to bake / build the app
FROM node:22-alpine3.19 as BUILD_IMAGE
WORKDIR /app

# COPY package.json .
COPY package*.json ./

# Install dependencies, including devDependencies needed for the build process (no --omit=dev)
RUN npm install

# This sets an environment variable named "PATH" to include the "./node_modules/.bin" directory. This ensures that locally installed Node.js modules can be executed directly from the command line without specifying their full path.
ENV PATH="./node_modules/.bin:$PATH"

# This command copies all the files and directories from the current directory (on your host machine, where the Dockerfile is located) into the "/app" directory within the Docker container. from . to . (workdir)
COPY . .

# Set default values for environment variables (This is set on github action for production test and main builds)
ARG VITE_PRODUCTION_BASE_URL=https://127.0.0.1:3000/
ARG VITE_PRODUCTION_BACKEND_API_URL=https://127.0.0.1:8000/v1/api/
ARG VITE_PRODUCTION_PROFILES_BASE_URL=https://127.0.0.1:3000/staff/
ARG VITE_SPMS_VERSION=3.0.0

# Set environment variables for runtime access
ENV VITE_PRODUCTION_BASE_URL=$VITE_PRODUCTION_BASE_URL
ENV VITE_PRODUCTION_BACKEND_API_URL=$VITE_PRODUCTION_BACKEND_API_URL
ENV VITE_PRODUCTION_PROFILES_BASE_URL=$VITE_PRODUCTION_PROFILES_BASE_URL
ENV VITE_SPMS_VERSION=$VITE_SPMS_VERSION

# This command runs the "npm build" script inside the container (it will use above env variables).
RUN npm run build 

# ======================== PRODUCTION IMAGE ========================
# Uses baked / buiilt app and server w/o large dependencies
FROM node:22-alpine3.19 as PRODUCTION_IMAGE

# Copy built files from the build stage to working dir
WORKDIR /client
COPY --from=BUILD_IMAGE /app/dist/ /client/dist/

# Perform operations as root to set ownership and permissions
USER root
RUN mkdir -p /client/node_modules && \
    chown -R node:node /client && \
    chmod -R u+rwX /client

# Install serve to serve the built files
RUN npm install serve -g

# Switch to the node user
USER node

EXPOSE 3000
# Use serve to serve the built files
CMD ["serve", "-s", "dist", "-l", "3000"]