chore: update Dockerfile and CI workflows to use pnpm for dependency management and build process

Author: chaxus

.github/workflows/ci.yml

@@ -8,8 +8,11 @@ on:
 
 jobs:
   lint:
-    name: Lint and Validate
-    runs-on: ubuntu-latest
+    name: Lint and Validate (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
 
     steps:
       - name: Checkout code
@@ -19,38 +22,40 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: "22"
-          cache: "npm"
+
+      - uses: pnpm/action-setup@v4
+        name: Install pnpm
+        id: pnpm-install
+        with:
+          version: 7
+          run_install: false
+
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - uses: actions/cache@v5
+        name: Setup pnpm cache
+        with:
+          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Run oxlint and TypeScript checks
-        run: npm run lint
+        run: pnpm run lint
 
       - name: Validate Docker Compose file
+        if: matrix.os == 'ubuntu-latest'
         run: docker compose -f docker-compose.yaml config --quiet
 
       - name: Lint Dockerfile with Hadolint
-        uses: hadolint/hadolint-action@v3.1.0
-        with:
-          dockerfile: Dockerfile
-          failure-threshold: error
-
-  docker-validation:
-    name: Docker Validation
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Validate docker-compose.yaml
-        run: |
-          echo "Validating docker-compose.yaml with Docker Compose..."
-          docker compose -f docker-compose.yaml config --quiet
-          echo "✓ docker-compose.yaml is valid"
-
-      - name: Lint Dockerfile
+        if: matrix.os == 'ubuntu-latest'
         uses: hadolint/hadolint-action@v3.1.0
         with:
           dockerfile: Dockerfile

.github/workflows/pages-build-site.yml

@@ -15,7 +15,52 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
+  build:
+    name: Build (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+
+      - uses: pnpm/action-setup@v4
+        name: Install pnpm
+        id: pnpm-install
+        with:
+          version: 7
+          run_install: false
+
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - uses: actions/cache@v5
+        name: Setup pnpm cache
+        with:
+          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm build
+
   deploy:
+    name: Deploy to GitHub Pages
+    needs: build
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
@@ -27,7 +72,7 @@ jobs:
       - name: Install Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 23
+          node-version: "22"
 
       - uses: pnpm/action-setup@v4
         name: Install pnpm
@@ -51,7 +96,7 @@ jobs:
             ${{ runner.os }}-pnpm-store-
 
       - name: Install dependencies
-        run: pnpm install
+        run: pnpm install --frozen-lockfile
 
       - name: Build
         run: pnpm build

Dockerfile

@@ -1,10 +1,22 @@
 ARG  NODE_VERSION=22
 FROM node:${NODE_VERSION} AS builder
 WORKDIR /app
-COPY package*.json ./ /app/
-RUN npm install
+
+# Install pnpm (Node.js image includes npm, so this is reliable)
+RUN npm install -g pnpm && \
+    pnpm --version
+
+# Copy package files
+COPY package.json pnpm-lock.yaml ./
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy source code
 COPY . .
-RUN npm run build
+
+# Build
+RUN pnpm run build
 
 #FROM nginxinc/nginx-unprivileged:stable-alpine
 #COPY --from=builder /app/dist /usr/share/nginx/html

package.json

@@ -12,7 +12,7 @@
     "format": "prettier --write .",
     "lint:ts": "oxlint && tsc --noEmit",
     "lint:docker": "docker compose -f docker-compose.yaml config --quiet",
-    "lint": "npm run lint:ts && npm run lint:docker"
+    "lint": "pnpm run lint:ts && pnpm run lint:docker"
   },
   "engines": {
     "node": ">=20.19.0"