First pass, using Grok as assist

Author: normanlorrain

.dockerignore

@@ -0,0 +1,4 @@
+.venv
+__pycache__
+*.pyc
+.git*

docker-compose.yml

@@ -1,18 +1,21 @@
 services:
   app:
-    image: python:3.14-slim
-    command: python -m mkdocs serve -a 0.0.0.0:8000 --watch-theme --livereload
-    entrypoint: /app/docker-entrypoint.sh
+    image: ghcr.io/astral-sh/uv:python3.14-trixie-slim
     working_dir: /app
+    entrypoint: /app/docker-entrypoint.sh
+    command: uv run -- mkdocs serve -a 0.0.0.0:8000 --watch-theme --livereload
     ports:
-      - 8000:8000
+      - "8000:8000"
     volumes:
       - .:/app
-      - pip-cache:/root/.cache/pip
+      - uv-cache:/root/.cache/uv
+      # Optional: protect .venv if you ever create one locally
+      - /app/.venv
     environment:
       - PYTHONUNBUFFERED=1
+      - UV_LINK_MODE=copy          # helps with bind mounts
     stdin_open: true
     tty: true
 
 volumes:
-  pip-cache:
+  uv-cache:

docker-entrypoint.sh

@@ -1,6 +1,10 @@
-#!/bin/bash
+#!/bin/sh
 set -e
 
-pip install -r requirements.txt
+# Sync dependencies (fast thanks to uv + cache)
+uv sync --frozen --no-dev   # or remove --no-dev if you want dev deps
+
+# Optional: make sure mkdocs is in PATH
+export PATH="/app/.venv/bin:$PATH"
 
 exec "$@"

pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "weeklydevchat-github-io"
+version = "0.1.0"
+requires-python = ">=3.14"
+dependencies = [
+    "mkdocs-material>=9.7.0",
+    "pillow>=12.2.0",
+    "pygments~=2.20.0",
+    "urllib3>=2.7.0",
+]
+
+# Optional but recommended
+[tool.uv]
+dev-dependencies = [
+    # put dev-only tools here if needed
+]