From 9054c25d0e6a5c15c8bccbbbf4a442bf5157bc52 Mon Sep 17 00:00:00 2001
From: myrmidex <myrmidex@myrmidex.net>
Date: Thu, 20 Aug 2026 23:32:21 +0200
Subject: [PATCH] 55 - Move the dev image to Debian so Playwright can run

---
 Dockerfile.dev                | 48 ++++++++++++++++++++---------------
 docker/dev/docker-compose.yml |  5 ++--
 2 files changed, 30 insertions(+), 23 deletions(-)

diff --git a/Dockerfile.dev b/Dockerfile.dev
index fa8c2fe..532be98 100644
--- a/Dockerfile.dev
+++ b/Dockerfile.dev
@@ -1,26 +1,34 @@
 # Development Dockerfile with FrankenPHP
-FROM dunglas/frankenphp:latest-php8.3-alpine
+#
+# Debian rather than Alpine so Playwright can run its own Chromium: it treats
+# debian12 as an officially supported platform and has no musl build at all.
+FROM dunglas/frankenphp:latest-php8.3-bookworm
 
-# Install system dependencies + development tools
-RUN apk add --no-cache \
-    nodejs \
-    npm \
-    git \
-    mysql-client \
-    vim \
-    bash \
-    nano \
-    chromium \
-    nss \
-    freetype \
-    harfbuzz \
-    ttf-freefont \
-    font-noto-emoji
+# Install system dependencies + development tools. Node comes from NodeSource
+# rather than apt: bookworm ships Node 18, below what Vite 6 targets.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        ca-certificates \
+        curl \
+        gnupg \
+        git \
+        default-mysql-client \
+        vim \
+        nano \
+        bash \
+        unzip \
+    && curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
+    && apt-get install -y --no-install-recommends nodejs \
+    && rm -rf /var/lib/apt/lists/*
 
-# Playwright ships glibc-linked browser builds that do not run on Alpine (musl),
-# so drive Alpine's own Chromium instead of downloading one.
-ENV PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 \
-    PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium-browser
+# Playwright's browser lives outside the bind-mounted /app so a host node_modules
+# never shadows it; --with-deps pulls the shared libraries Chromium needs.
+ENV PLAYWRIGHT_BROWSERS_PATH=/opt/playwright
+COPY package.json package-lock.json /tmp/pw/
+RUN cd /tmp/pw \
+    && npm ci --no-audit --no-fund \
+    && ./node_modules/.bin/playwright install --with-deps chromium \
+    && rm -rf /tmp/pw
 
 # Install PHP extensions including xdebug for development
 RUN install-php-extensions \
diff --git a/docker/dev/docker-compose.yml b/docker/dev/docker-compose.yml
index b4a71b7..22f0c20 100644
--- a/docker/dev/docker-compose.yml
+++ b/docker/dev/docker-compose.yml
@@ -41,9 +41,8 @@ services:
       # Vite
       VITE_HOST: "0.0.0.0"
 
-      # Playwright drives Alpine's system Chromium (musl); see Dockerfile.dev
-      PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: "1"
-      PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH: "/usr/bin/chromium-browser"
+      # Chromium is baked into the image outside /app; see Dockerfile.dev
+      PLAYWRIGHT_BROWSERS_PATH: "/opt/playwright"
     volumes:
       # Mount entire project for hot reload with SELinux context
       - ../..:/app:Z