Merge branch 'master' into copilot/fix-262

Author: dannystaple

.dockerignore

@@ -1,3 +1,6 @@
+# Aggressive .dockerignore for faster Docker builds
+# Most content is volume-mounted in docker-compose.yml for development
+
 _site
 node_modules
 .git
@@ -7,7 +10,50 @@ node_modules
 .mega-linter.yml
 .pre-commit-config.yaml
 .shellcheckrc
-docker-compose.yml
+docker-compose*.yml
 serve.Dockerfile
 README.md
+
+# Large directories that will be volume-mounted for development
+# These are the primary culprits for slow build context transfer
 _image_sources
+galleries
+content
+_drafts
+assets
+
+# Other directories that will be volume-mounted
+products
+navigation_and_indexes
+error_pages
+admin
+_posts
+_data
+_includes
+
+# Development and build artifacts
+dist
+*.log
+.DS_Store
+Thumbs.db
+
+# IDE files
+.vscode
+.idea
+*.swp
+*.swo
+
+# Temporary files
+.tmp
+tmp
+
+# Keep essential files for build
+!package.json
+!package-lock.json
+!.eleventy.js
+!_config.yml
+!webpack.config.js
+!src/
+!tests/
+!.github/scripts/staging/default.conf
+!htaccess

.eleventyignore

@@ -4,3 +4,4 @@
 ./tests
 ./.github
 Dockerfile
+DOCKER_OPTIMIZATION.md

.github/copilot-instructions.md

@@ -12,23 +12,14 @@ Orionrobots is a static website about robotics using Eleventy (11ty) static site
 - Build assets and site manually:
   - `docker compose run dist` -- builds webpack bundle.js, takes ~30 seconds
   - `docker compose run build` -- builds full static site, takes ~3 minutes. Set timeout to 240+ seconds.
-- Alternative native workflow:
-  ```bash
-  npm install
-  npm run dist
-  npm run 11ty
-  ```
 
 ### Development Server
 - Run local development server:
   - `docker compose up serve` -- starts Eleventy dev server on port 8081, **NEVER CANCEL** - builds then watches files. Set timeout to 300+ seconds for initial build.
-  - Alternative native: `npm run serve` -- starts Eleventy dev server directly
-  - Manual serving: After building, serve with Python: `cd _site && python3 -m http.server 8082`
 
 ### Testing Commands
 - BDD integration tests:
   - `docker compose run test` -- runs Cucumber.js tests with Playwright in containerized environment
-  - Alternative native: `npm run test:bdd` or `npm test` -- runs tests directly on host
   - **Note**: Playwright installation may fail in some CI environments
   - Tests require a running staging server to test against
 
@@ -49,7 +40,6 @@ Always test these key pages that are verified in CI:
 
 ### Build Verification
 - Run `docker compose run dist && docker compose run build` and verify `_site` directory is created with content
-- Alternative native: `npm run dist && npm run 11ty`
 - Check that `_site/index.html` exists and contains proper HTML structure
 - Verify `dist/bundle.js` exists and is approximately 330KB
 
@@ -68,6 +58,7 @@ dist/                -- Webpack build output (bundle.js)
 docker-compose.yml   -- Docker development environment setup
 package.json         -- npm dependencies and scripts
 src/                 -- Source files for Webpack
+tests/staging        -- Gherkin-based BDD tests for website functionality
 webpack.config.js    -- Webpack configuration
 ```
 
@@ -79,16 +70,13 @@ webpack.config.js    -- Webpack configuration
 ## Build Process Details
 
 ### Build Order (Critical)
-1. **Webpack Build** (`docker compose run dist` or `npm run dist`): Creates `dist/bundle.js` with CSS and JS assets
-2. **Eleventy Build** (`docker compose run build` or `npm run 11ty`): Processes markdown, creates HTML, copies assets to `_site/`
+1. **Webpack Build** (`docker compose run dist`): Creates `dist/bundle.js` with CSS and JS assets
+2. **Eleventy Build** (`docker compose run build`): Processes markdown, creates HTML, copies assets to `_site/`
 
 ### Timing Expectations
 - Docker compose up: ~4-5 minutes for initial build and start (set 300+ second timeout)
 - Docker dist build: ~30 seconds (set 60+ second timeout)
 - Docker site build: ~3 minutes (**NEVER CANCEL** - set 240+ second timeout)
-- Alternative native npm install: ~1 minute (standard timeout OK)
-- Alternative native webpack dist: ~7 seconds (set 30+ second timeout)  
-- Alternative native Eleventy build: ~2.5 minutes (**NEVER CANCEL** - set 180+ second timeout)
 
 ### Known Build Warnings
 - Sass deprecation warnings about @import rules (normal, build continues)
@@ -132,6 +120,9 @@ This creates properly structured content with frontmatter in `content/YYYY/MM/`
 - CSS/JS: Add to `src/` and import in `src/index.js`
 - Static files: Use Eleventy passthrough copy in `.eleventy.js`
 
+### Adding scripts or utilities
+- Ensure these are run through a docker compose command
+
 ### Troubleshooting Build Issues
 1. Clear containers and rebuild: `docker compose down && docker compose build --no-cache`
 2. Clear build outputs: `docker compose run --rm base rm -rf _site dist`
@@ -162,4 +153,4 @@ This is a Jekyll-to-Eleventy migrated project (now fully Eleventy) with:
 - Extensive robotics content and tutorials
 - Apache hosting with custom htaccess rules
 
-**CRITICAL REMINDER**: Use Docker Compose as the primary development method. Never cancel long-running builds - they can take 3-5+ minutes for initial setup.
+**CRITICAL REMINDER**: Use Docker Compose as the primary development method. Never cancel long-running builds - they can take 3-5+ minutes for initial setup.

Dockerfile

@@ -1,24 +1,28 @@
+# Development build - minimal context needed since content is volume-mounted
 FROM node:24-bullseye AS base
 
 # Create app directory
 WORKDIR /app/src
 
-# Install dependencies
+# Copy package files and install dependencies
+# This is all that's needed for development since source is volume-mounted
 COPY package.json package-lock.json ./
 RUN npm ci
 
+# Development debug build 
 FROM base AS debug
 
 RUN apt-get update && apt-get install -y \
     less \
     iputils-ping \
     dnsutils
 
-# Copy app source for development
-COPY . /app/src
+# For development, source code is volume-mounted, not copied
 
+# Broken link checker stage
 FROM dcycle/broken-link-checker:3 AS broken_link_checker
 
+# Production HTTP server build - needs full content
 FROM httpd:2.4.64 AS httpd_serve
 
 # Install curl for healthcheck
@@ -45,6 +49,7 @@ RUN if [ -f /tmp/build_context/httpd.conf ]; then \
 # Copy site content to web directory
 COPY . /usr/local/apache2/htdocs/
 
+# Test build - needs some content for testing
 FROM base AS tests
 
 # Install necessary packages for Playwright
@@ -61,13 +66,11 @@ RUN apt-get update && apt-get install -y \
 # Install Playwright browsers
 RUN npx playwright install chromium --with-deps
 
-# Copy app source for testing
-COPY . /app/src
+# Copy test files
+COPY tests/ ./tests/
 
 # Set default command to run BDD tests
 CMD ["npm", "run", "test:bdd"]
 
+# Default stage for development - just the base with npm dependencies
 FROM base
-
-# Copy app source for the final stage
-COPY . /app/src

dev.Dockerfile

@@ -0,0 +1,25 @@
+# Minimal development Dockerfile
+# Only installs npm dependencies since content is volume-mounted
+FROM node:24-bullseye AS base
+
+# Create app directory
+WORKDIR /app/src
+
+# Copy package files and install dependencies
+COPY package.json package-lock.json ./
+
+# Optimize npm ci for better performance in CI environments
+RUN npm ci --prefer-offline --no-audit --progress=false
+
+# Development debug build 
+FROM base AS debug
+
+RUN apt-get update && apt-get install -y \
+    less \
+    iputils-ping \
+    dnsutils
+
+# Source code will be volume-mounted at runtime
+
+# Default stage - just npm dependencies installed
+FROM base

docker-compose.yml

@@ -2,7 +2,7 @@ services:
   serve:
     build:
       context: .
-      dockerfile: Dockerfile
+      dockerfile: dev.Dockerfile
     command: ["npm", "run", "serve"]
     volumes:
       - .:/app/src
@@ -16,7 +16,7 @@ services:
   dist:
     build:
       context: .
-      dockerfile: Dockerfile
+      dockerfile: dev.Dockerfile
     command: ["npm", "run", "dist"]
     volumes:
       - .:/app/src
@@ -25,7 +25,7 @@ services:
   build:
     build:
       context: .
-      dockerfile: Dockerfile
+      dockerfile: dev.Dockerfile
     command: ["npm", "run", "11ty"]
     volumes:
       - .:/app/src
@@ -61,7 +61,7 @@ services:
   shell:
     build:
       context: .
-      dockerfile: Dockerfile
+      dockerfile: dev.Dockerfile
       target: debug
     command: ["bash"]
     volumes: