[dark-mode] Add production deployment and setup instructions

- Update Dockerfile.prod to use Node 20 with --ignore-engines for yarn installs
- Update docker-compose.yml to build from local source with proper port mapping
- Add docs-config.local.yaml with required port and configuration
- Update PULL_REQUEST.md with Getting Started guide for yarn dev and Docker deployment
- Document Node.js version requirements and --ignore-engines usage
- Include database migration notes for nedb to @seald-io/nedb"

Author: Hunta

.github/specs/dark-mode/PULL_REQUEST.md

@@ -96,3 +96,59 @@ yarn test:e2e:ui
 ```
 
 Toggle the sun/moon button in the header to switch themes. Preference persists across reloads and pages. Remove localStorage key `codex-docs-theme` to reset to system default.
+
+### Getting Started
+
+#### Prerequisites
+
+- **Node.js 20+** is required (eslint-plugin-jsdoc@62.9.0+ only supports Node 20+)
+- Docker (optional, for containerized deployment)
+
+#### Local Development with Yarn
+
+1. **Install dependencies:**
+   ```bash
+   yarn install --ignore-engines
+   ```
+   (The `--ignore-engines` flag bypasses Node version warnings for some transitive dependencies)
+
+2. **Start the development server:**
+   ```bash
+   yarn dev
+   ```
+   This runs the backend on `http://localhost:3000` and watches frontend assets.
+
+3. **Access the app:**
+   Open http://localhost:3000 and use the sun/moon toggle button in the header (top-right) to switch themes.
+
+#### Production with Docker
+
+1. **Create a local config file:**
+   ```bash
+   # Copy the default config
+   cp docs-config.yaml docs-config.local.yaml
+   ```
+   Update `port: 7777` and `host: "0.0.0.0"` in `docs-config.local.yaml` if needed.
+
+2. **Build and start the container:**
+   ```bash
+   docker compose up -d --build
+   ```
+   The app will be available at http://localhost:7777
+
+3. **Verify the container:**
+   ```bash
+   docker logs codexdocs-docs-1 --tail 20
+   ```
+   You should see: `CodeX Docs server is running`
+
+#### Important Notes
+
+- **Node 22 on local machine:** If you're running Node 22 locally and encounter `eslint-plugin-jsdoc` engine errors during `yarn install`, use the `--ignore-engines` flag:
+  ```bash
+  yarn install --ignore-engines
+  ```
+
+- **Docker builds:** The Dockerfile.prod uses Node 20 and includes `--ignore-engines` flags in yarn install commands to ensure compatibility.
+
+- **Database:** This PR migrates from `nedb` to `@seald-io/nedb`. The new package is a drop-in replacement with identical on-disk format — no data migration required.

docker-compose.yml

@@ -1,6 +1,8 @@
 services:
   docs:
-    image: ghcr.io/codex-team/codex.docs:v2.0.0-rc.8
+    build:
+      context: .
+      dockerfile: docker/Dockerfile.prod
     ports:
       - "7777:7777"
     volumes:

docker/Dockerfile.prod

@@ -1,5 +1,5 @@
 # Stage 1 - build
-FROM node:16.14.0-alpine3.15 as build
+FROM node:20-alpine as build
 
 ## Install build toolchain, install node deps and compile native add-ons
 RUN apk add --no-cache python3 make g++ git
@@ -8,18 +8,18 @@ WORKDIR /usr/src/app
 
 COPY package.json yarn.lock ./
 
-RUN yarn install --production
+RUN yarn install --production --ignore-engines
 
 RUN cp -R node_modules prod_node_modules
 
-RUN yarn install
+RUN yarn install --ignore-engines
 
 COPY . .
 
 RUN yarn build-all
 
 # Stage 2 - make final image
-FROM node:16.14.0-alpine3.15
+FROM node:20-alpine
 
 WORKDIR /usr/src/app