Noderax Docs

Public documentation site for Noderax, built with Next.js, Fumadocs, and Vercel deployment.

Scope

This repo is the long-form docs surface for:

• installer-managed self-hosted control-plane setup and operations
• operator workflows in the web dashboard
• generated API reference from a checked-in OpenAPI snapshot
• architecture and release notes for the current platform line

Commands

pnpm install
pnpm sync:openapi
pnpm typecheck
pnpm build

OpenAPI sync

The docs site does not read a live Swagger endpoint. It expects a checked-in schema snapshot at openapi/openapi.json.

To refresh it from a sibling checkout:

pnpm sync:openapi

That command runs pnpm openapi:export in ../noderax-api when available and copies the exported schema into this repo.

Deployment

Deploy on Vercel with the standard Next.js build command:

pnpm build

Dependency updates (2026-09-05)

Use Node.js 24.15+ and pnpm 10.33.0. TypeScript stays on 6.0.x to match typescript-eslint support. ESLint stays on 9.x to match Next.js lint plugins; newly enabled React Compiler diagnostics remain warnings. Fumadocs OpenAPI 11 renders through components/openapi-page.tsx. Keep every local OpenAPI schema reference resolvable before running pnpm build.