feat(docker): include built-in documentation and templates for seeding

Author: Chris Funderburg

.dockerignore

@@ -13,6 +13,7 @@ dist/
 *.md
 !README.md
 !data/templates/**
+!data/Codex Documentation/README.md
 .env*
 .DS_Store
 *.log

Dockerfile

@@ -46,6 +46,9 @@ COPY --from=builder /app/client/dist ./client/dist
 # Include default templates in the image for first-run seeding into the mounted data volume
 COPY data/templates ./seed/templates
 
+# Include built-in documentation that should always be synced into the mounted data volume
+COPY ["data/Codex Documentation/README.md", "./seed/docs/Codex Documentation/README.md"]
+
 # Create data directory and set permissions
 RUN mkdir -p /app/data && chown -R codex:codex /app
 
@@ -64,6 +67,10 @@ ENV DATA_DIR=/app/data
 ENV CODEX_SEED_TEMPLATES=true
 ENV CODEX_SEED_TEMPLATES_DIR=/app/seed/templates
 
+# Always sync built-in documentation README into the data volume on startup
+ENV CODEX_SYNC_BUILTIN_DOCS=true
+ENV CODEX_SYNC_BUILTIN_DOCS_DIR=/app/seed/docs
+
 # Health check
 HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
   CMD wget --no-verbose --tries=1 --spider http://localhost:3001/api || exit 1

README.md

@@ -8,7 +8,7 @@
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
 [![React](https://img.shields.io/badge/React-19-61dafb)](https://reactjs.org/)
-[![Express](https://img.shields.io/badge/Express-4.18-green)](https://expressjs.com/)
+[![Express](https://img.shields.io/badge/Express-5.2.1-green)](https://expressjs.com/)
 
 ## ✨ Features
 
@@ -378,7 +378,7 @@ Then open [http://localhost:3000](http://localhost:3000) in your browser!
 
 ### Prerequisites
 
-- Node.js 18+ and npm
+- Node.js 25+ and npm
 - macOS, Linux, or Windows with WSL
 
 ### Option 1: Using Make (Recommended)
@@ -482,8 +482,8 @@ docker pull bocan/codex:latest
 
 **Available tags**:
 - `latest` - Latest stable release
-- `2.7.0` - Specific version (example)
-- `2.7` - Minor version (example)
+- `2.16.0` - Specific version (example)
+- `2.16` - Minor version (example)
 - `2` - Major version (example)
 
 **Image verification** (signed with Cosign):
@@ -1037,31 +1037,31 @@ The TOC appears as a floating widget on the right side of the preview pane when
 ## 💻 Tech Stack
 
 ### Backend
-- **[Express](https://expressjs.com/)** `^4.18.2` - Fast, unopinionated web framework
+- **[Express](https://expressjs.com/)** `^5.2.1` - Fast, unopinionated web framework
 - **[TypeScript](https://www.typescriptlang.org/)** `^5.3.3` - Type-safe JavaScript
-- **[CORS](https://www.npmjs.com/package/cors)** `^2.8.5` - Cross-origin resource sharing
+- **[CORS](https://www.npmjs.com/package/cors)** `^2.8.6` - Cross-origin resource sharing
 - **[ts-node-dev](https://www.npmjs.com/package/ts-node-dev)** `^2.0.0` - Development server with auto-reload
 
 **Testing:**
-- **[Jest](https://jestjs.io/)** `^29.7.0` - Testing framework
-- **[Supertest](https://www.npmjs.com/package/supertest)** `^6.3.3` - HTTP assertion library
+- **[Jest](https://jestjs.io/)** `^30.2.0` - Testing framework
+- **[Supertest](https://www.npmjs.com/package/supertest)** `^7.2.2` - HTTP assertion library
 - **[ts-jest](https://www.npmjs.com/package/ts-jest)** `^29.1.1` - TypeScript preprocessor for Jest
 
 ### Frontend
-- **[React](https://reactjs.org/)** `^18.2.0` - UI library
+- **[React](https://reactjs.org/)** `^19.2.4` - UI library
 - **[TypeScript](https://www.typescriptlang.org/)** `^5.3.3` - Type-safe JavaScript
-- **[Vite](https://vitejs.dev/)** `^5.0.11` - Next-generation frontend tooling
-- **[React Markdown](https://www.npmjs.com/package/react-markdown)** `^9.0.1` - Markdown renderer
+- **[Vite](https://vitejs.dev/)** `^7.3.1` - Next-generation frontend tooling
+- **[React Markdown](https://www.npmjs.com/package/react-markdown)** `^10.1.0` - Markdown renderer
 - **[remark-gfm](https://www.npmjs.com/package/remark-gfm)** `^4.0.0` - GitHub Flavored Markdown
-- **[Axios](https://axios-http.com/)** `^1.6.5` - HTTP client
+- **[Axios](https://axios-http.com/)** `^1.13.4` - HTTP client
 
 **Testing:**
-- **[Vitest](https://vitest.dev/)** `^1.1.3` - Unit test framework
+- **[Vitest](https://vitest.dev/)** `^4.0.18` - Unit test framework
 - **[Testing Library](https://testing-library.com/)** - React testing utilities
-- **[jsdom](https://www.npmjs.com/package/jsdom)** `^23.2.0` - DOM implementation
+- **[jsdom](https://www.npmjs.com/package/jsdom)** `^28.0.0` - DOM implementation
 
 ### Development Tools
-- **[Concurrently](https://www.npmjs.com/package/concurrently)** `^8.2.2` - Run multiple commands
+- **[Concurrently](https://www.npmjs.com/package/concurrently)** `^9.2.1` - Run multiple commands
 - **ESLint** - Code linting
 - **Prettier** - Code formatting (optional)
 

data/Codex Documentation/README.md

@@ -8,12 +8,14 @@
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
 [![React](https://img.shields.io/badge/React-19-61dafb)](https://reactjs.org/)
-[![Express](https://img.shields.io/badge/Express-4.18-green)](https://expressjs.com/)
+[![Express](https://img.shields.io/badge/Express-5.2.1-green)](https://expressjs.com/)
 
 ## ✨ Features
 
 - 📁 **Folder Management**: Create, delete, and rename folders in a collapsible tree view with right-click context menus
 - 📝 **Markdown Pages**: Create and edit markdown documents with GitHub Flavored Markdown support
+- 🧩 **Smart Templates**: Create new pages from reusable templates (stored under `data/templates/`)
+- 📊 **Mermaid Diagrams**: Render Mermaid code fences in preview/reading mode, with export/download support
 - 🎨 **Three-Pane Layout**: Folder tree (left), markdown editor (center), live preview (right)
 - 📐 **Fully Resizable**: Drag to resize both horizontal panes (left/right) and vertical sections (folder tree/page list)
 - 🌓 **Theme Options**: Auto-detects system theme preference with manual override - cycles through auto/light/dark/high-contrast modes
@@ -38,7 +40,32 @@
 - 🔐 **Password Protection**: Simple password-based authentication to secure your data
 - 🛡️ **Security Features**: Rate limiting, request logging, and security headers
 
-## 🔐 Security & Logging.
+## 🧩 Smart Templates
+
+When creating a new page, Codex can start from a template instead of a blank page.
+
+- Templates live in `data/templates/*.md`
+- Optional frontmatter at the top of the template file:
+  - `template: Your Template Name` (display name)
+  - `autoname: true|false` (auto-generate a filename when creating)
+- The frontmatter is stripped from the created page content automatically
+
+## 📊 Mermaid Diagrams
+
+Codex supports Mermaid diagrams in markdown via fenced code blocks:
+
+````md
+```mermaid
+graph TD
+  A --> B
+```
+````
+
+- Diagrams render in the live preview and in reading mode (open in new window)
+- You can download rendered diagrams as SVG
+- Export flows (e.g. Word/PDF) include diagrams as images rather than raw Mermaid text
+
+## 🔐 Security & Logging
 
 Codex includes several security features to protect your data:
 
@@ -351,7 +378,7 @@ Then open [http://localhost:3000](http://localhost:3000) in your browser!
 
 ### Prerequisites
 
-- Node.js 18+ and npm
+- Node.js 25+ and npm
 - macOS, Linux, or Windows with WSL
 
 ### Option 1: Using Make (Recommended)
@@ -455,8 +482,8 @@ docker pull bocan/codex:latest
 
 **Available tags**:
 - `latest` - Latest stable release
-- `2.7.0` - Specific version (example)
-- `2.7` - Minor version (example)
+- `2.16.0` - Specific version (example)
+- `2.16` - Minor version (example)
 - `2` - Major version (example)
 
 **Image verification** (signed with Cosign):
@@ -523,6 +550,9 @@ docker stop codex && docker rm codex
 **Volume Mounting**:
 - `./data:/app/data` - Persists your wiki data outside the container
 
+**Templates on first run**:
+- The Docker image includes built-in starter templates; on first startup, if `data/templates/` is missing or empty, Codex will copy the defaults into it.
+
 ### Authentication in Docker
 
 **Important**: Due to secure cookie requirements, there are two ways to run Codex with authentication:
@@ -1007,31 +1037,31 @@ The TOC appears as a floating widget on the right side of the preview pane when
 ## 💻 Tech Stack
 
 ### Backend
-- **[Express](https://expressjs.com/)** `^4.18.2` - Fast, unopinionated web framework
+- **[Express](https://expressjs.com/)** `^5.2.1` - Fast, unopinionated web framework
 - **[TypeScript](https://www.typescriptlang.org/)** `^5.3.3` - Type-safe JavaScript
-- **[CORS](https://www.npmjs.com/package/cors)** `^2.8.5` - Cross-origin resource sharing
+- **[CORS](https://www.npmjs.com/package/cors)** `^2.8.6` - Cross-origin resource sharing
 - **[ts-node-dev](https://www.npmjs.com/package/ts-node-dev)** `^2.0.0` - Development server with auto-reload
 
 **Testing:**
-- **[Jest](https://jestjs.io/)** `^29.7.0` - Testing framework
-- **[Supertest](https://www.npmjs.com/package/supertest)** `^6.3.3` - HTTP assertion library
+- **[Jest](https://jestjs.io/)** `^30.2.0` - Testing framework
+- **[Supertest](https://www.npmjs.com/package/supertest)** `^7.2.2` - HTTP assertion library
 - **[ts-jest](https://www.npmjs.com/package/ts-jest)** `^29.1.1` - TypeScript preprocessor for Jest
 
 ### Frontend
-- **[React](https://reactjs.org/)** `^18.2.0` - UI library
+- **[React](https://reactjs.org/)** `^19.2.4` - UI library
 - **[TypeScript](https://www.typescriptlang.org/)** `^5.3.3` - Type-safe JavaScript
-- **[Vite](https://vitejs.dev/)** `^5.0.11` - Next-generation frontend tooling
-- **[React Markdown](https://www.npmjs.com/package/react-markdown)** `^9.0.1` - Markdown renderer
+- **[Vite](https://vitejs.dev/)** `^7.3.1` - Next-generation frontend tooling
+- **[React Markdown](https://www.npmjs.com/package/react-markdown)** `^10.1.0` - Markdown renderer
 - **[remark-gfm](https://www.npmjs.com/package/remark-gfm)** `^4.0.0` - GitHub Flavored Markdown
-- **[Axios](https://axios-http.com/)** `^1.6.5` - HTTP client
+- **[Axios](https://axios-http.com/)** `^1.13.4` - HTTP client
 
 **Testing:**
-- **[Vitest](https://vitest.dev/)** `^1.1.3` - Unit test framework
+- **[Vitest](https://vitest.dev/)** `^4.0.18` - Unit test framework
 - **[Testing Library](https://testing-library.com/)** - React testing utilities
-- **[jsdom](https://www.npmjs.com/package/jsdom)** `^23.2.0` - DOM implementation
+- **[jsdom](https://www.npmjs.com/package/jsdom)** `^28.0.0` - DOM implementation
 
 ### Development Tools
-- **[Concurrently](https://www.npmjs.com/package/concurrently)** `^8.2.2` - Run multiple commands
+- **[Concurrently](https://www.npmjs.com/package/concurrently)** `^9.2.1` - Run multiple commands
 - **ESLint** - Code linting
 - **Prettier** - Code formatting (optional)
 

server/src/services/fileSystem.ts

@@ -121,9 +121,39 @@ export class FileSystemService {
       await fs.mkdir(this.dataDir, { recursive: true });
     }
 
+    await this.syncBuiltinDocsIfConfigured();
     await this.seedTemplatesIfConfigured();
   }
 
+  private async syncBuiltinDocsIfConfigured(): Promise<void> {
+    if (process.env.CODEX_SYNC_BUILTIN_DOCS !== "true") {
+      return;
+    }
+
+    const seedDir = process.env.CODEX_SYNC_BUILTIN_DOCS_DIR;
+    if (!seedDir) {
+      return;
+    }
+
+    const sourceReadme = path.join(seedDir, "Codex Documentation", "README.md");
+    const destReadmeRelative = path.join("Codex Documentation", "README.md");
+
+    try {
+      const destDir = this.validatePath("Codex Documentation");
+      await fs.mkdir(destDir, { recursive: true });
+
+      const destReadme = this.validatePath(destReadmeRelative);
+      await fs.copyFile(sourceReadme, destReadme);
+
+      // Invalidate caches that might be affected
+      this.cache.invalidate("folder-tree:");
+      this.cache.invalidate("pages:Codex Documentation");
+      this.cache.invalidate(`page:${destReadmeRelative}`);
+    } catch {
+      // Best-effort sync; ignore failures to avoid blocking startup
+    }
+  }
+
   private async seedTemplatesIfConfigured(): Promise<void> {
     if (process.env.CODEX_SEED_TEMPLATES !== "true") {
       return;