The site is built with Next.js and Nextra, a documentation framework. Content is written in MDX (Markdown + JSX) in the src/content/ directory.
Project structure:
src/content/- MDX content filessrc/content/_meta.ts- Page configuration (titles, navigation)src/app/- Next.js App Router structuresrc/components/- React componentspublic/- Static assets
Git hooks: This project uses Lefthook for Git hooks:
- Pre-commit: Runs ESLint auto-fix and TypeScript type checking
- Commit-msg: Validates conventional commit format
Use Node.js 26 and the pnpm version pinned in package.json. pnpm 12 reads
dependency build permissions from allowBuilds in pnpm-workspace.yaml.
The trust policy remains enabled; its Lefthook exception covers only 2.2.2,
whose npm release lacks provenance.
ESLint 10 uses eslint-plugin-jsx-a11y-x for accessibility checks.
pnpm check:types runs TypeScript 7's tsc through the @typescript/native
package alias. The typescript alias supplies @typescript/typescript6 for
typescript-eslint, Next.js, and Nextra's Twoslash dependencies, which still
need the JavaScript compiler API. Its separate executable is tsc6.
This follows Microsoft's side-by-side setup.
CI uses Ubuntu 24.04, which the pinned Playwright release supports.
The pnpm patch for nextra-theme-docs@4.6.1 includes children when validating
layout props, fixing Nextra's incompatibility with Zod 4.4 and later.
Remove the patch once an upstream Nextra release includes the fix.
To open the dev server through a LAN address, set
NEXT_ALLOWED_DEV_ORIGINS=192.168.1.10 in .env.local, using your server's
IP or hostname, then restart pnpm dev. Separate multiple hosts with commas.
Build the site:
pnpm buildThis generates a static export in the ./out directory.
Lint your code:
pnpm lint # Check for errors
pnpm lint:fix # Auto-fix errorsType check:
pnpm run check:typesCheck for unused dependencies:
pnpm run check:depsAnalyze bundle size:
pnpm run analyzeThe site is automatically deployed to Cloudflare Pages when changes are pushed to the develop branch. The CI workflow:
- Runs linting and type checking
- Builds the static site
- Deploys to Cloudflare Pages
You can preview the production build locally by serving the ./out directory:
npx serve ./outSee WebAuthn hosting for the independent passkey association deployment.