Add Docker Compose for the static site

Author: ovvesley

README.md

@@ -7,3 +7,5 @@ The live website is a static Next.js application in [`web/`](web/README.md). Git
 [Update and deployment workflow](https://github.com/UFFeScience/uffescience.github.io/actions/workflows/pages.yml) runs weekly on Monday at 09:00 Brasília and can be run manually. Apify credentials are stored only in Actions Secrets and ignored local environment files.
 
 See [development and content documentation](web/README.md) for local preview, synchronization, storage and deployment details.
+
+To run locally with Docker, execute `docker compose up --build -d` from this directory, then open http://localhost:8080/. Stop it with `docker compose down`.

compose.yml

@@ -0,0 +1,9 @@
+name: uffescience
+
+services:
+  web:
+    build:
+      context: ./web
+    ports:
+      - '127.0.0.1:${PORT:-8080}:80'
+    restart: unless-stopped

web/.dockerignore

@@ -0,0 +1,12 @@
+node_modules
+.next
+out
+.env*
+public/media
+data/sync.lock
+data/*.tmp
+data/sync*.log
+scripts/__pycache__
+.venv
+*.log
+.DS_Store

web/Dockerfile

@@ -0,0 +1,17 @@
+FROM node:22-alpine AS build
+
+WORKDIR /app
+ENV NEXT_TELEMETRY_DISABLED=1
+
+COPY package.json package-lock.json ./
+RUN npm ci
+
+COPY . .
+RUN npm run build && node scripts/check-static.mjs
+
+FROM nginx:stable-alpine AS runtime
+
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+COPY --from=build /app/out /usr/share/nginx/html
+
+EXPOSE 80

web/README.md

@@ -15,6 +15,20 @@ python3 -m http.server 3007 --directory out
 
 `npm run dev -- --port 3007` is also available for editing. No deployed Node.js server, API routes, ISR or remote image optimization is required. Every publication slug and historical alias is generated during the build. HTML, CSS, JavaScript and archived images are published from `out/`.
 
+## Docker Compose
+
+From the repository root (the directory containing `compose.yml`):
+
+```sh
+docker compose up --build -d
+docker compose logs -f web
+docker compose down
+```
+
+Open http://localhost:8080/. To use another port, run `PORT=8081 docker compose up --build -d`.
+
+The multi-stage image builds and validates the static export with Node.js, then serves it with Nginx. It includes the stored content and archived images; no Apify or GitHub credentials are needed or copied into the image. Individual publication URLs work directly, and unknown paths return HTTP 404. Run the build command again after changing source or stored content. Content collection remains in the weekly GitHub Actions workflow.
+
 ## Stored content
 
 - `data/publications.json`: full publication history, stable slugs, authors, dates, original LinkedIn links, deduplication aliases and collection metadata.

web/nginx.conf

@@ -0,0 +1,13 @@
+server {
+    listen 80;
+    server_name _;
+
+    root /usr/share/nginx/html;
+    index index.html;
+
+    location / {
+        try_files $uri $uri/ =404;
+    }
+
+    error_page 404 /404.html;
+}

web/package.json

@@ -10,8 +10,8 @@
     "sync:weekly": "node scripts/sync-weekly.mjs",
     "prebuild": "node scripts/prepare-static.mjs",
     "sync:github": "node scripts/sync-github.mjs",
-    "format": "prettier --write app lib scripts next.config.mjs package.json README.md ../README.md ../.github ../.prettierrc.json",
-    "format:check": "prettier --check app lib scripts next.config.mjs package.json README.md ../README.md ../.github ../.prettierrc.json",
+    "format": "prettier --write app lib scripts next.config.mjs package.json README.md ../README.md ../.github ../.prettierrc.json ../compose.yml",
+    "format:check": "prettier --check app lib scripts next.config.mjs package.json README.md ../README.md ../.github ../.prettierrc.json ../compose.yml",
     "format:python": "python3 -m black scripts",
     "format:python:check": "python3 -m black --check scripts"
   },