Docs Site

This documentation site is a Nextra 4 + nextra-theme-docs Next.js app under docs-site/, configured for static export.

Layout


docs-site/
├── package.json            # next 16 + nextra 4 + react 19
├── next.config.mjs         # nextra wrapper, output: 'export', trailingSlash: true
├── mdx-components.js        # MDX component wiring
├── app/
│   ├── layout.jsx          # navbar logo, footer, SEO meta, theme
│   └── [[...mdxPath]]/page.jsx
├── content/                # MDX pages + _meta.js ordering files
│   ├── _meta.js
│   ├── index.mdx
│   ├── getting-started/
│   ├── architecture/
│   ├── features/
│   ├── cli/
│   ├── deployment/
│   └── concepts/
├── public/logo.svg
└── styles/custom.css

Section and page order is controlled by _meta.js files — one per directory. Pages are MDX in content/.

Commands


cd docs-site
npm install
npm run dev          # local hot-reload on http://localhost:3000
npm run build        # static export → out/

npm run build writes the static site to docs-site/out/.

Reference — how the sibling wfm-tools docs site deploys. The wfm-tools project (wfm-datawarehouse/docs-site, the same Nextra framework) is built by its GitLab pipeline (ci/build.yml), which runs npm ci && npm run build and syncs out/ to a docs S3 bucket fronted by CloudFront (e.g. docs.wfmeasy-dev.copebit.ch). Its dashboard links to the configured docs_domain. agent-runner’s CI/infrastructure wiring for this site is handled separately; this page documents the build only.