Cocos Docs

This is the source code for the Cocos AI documentation site, built with Next.js and Fumadocs.

The site is configured to live under:

https://www.ultraviolet.rs/docs/cocos-ai

Getting Started

Prerequisites

• Node.js (v22 or newer)
• pnpm (v11 or newer)

Installation

pnpm install

Develop

Run the development server:

pnpm dev

Open http://localhost:3000/docs/cocos-ai with your browser to see the docs.

Validate

pnpm run lint
pnpm run types:check

Biome is used for code linting and formatting:

pnpm run lint:fix
pnpm run format

Build

pnpm run build

The build exports static assets to out/, then nests the export under out/docs/cocos-ai so Cloudflare Workers can serve the docs at the configured base path.

Project Structure

• app/: Next.js app router pages and layouts.
• content/docs/: Documentation content in Markdown and MDX.
• lib/: Utility functions and Fumadocs configuration.
• public/: Static assets, Cloudflare _headers, _redirects, and robots.txt.
• worker/: Cloudflare Worker script that proxies /img/... requests to R2; runs only for requests that don't match a static file. See scripts/README.md.
• scripts/nest-static-export.mjs: Moves the static export under out/docs/cocos-ai.
• scripts/publish-image.mjs: Maintainer-only image publishing tool. See scripts/README.md.
• wrangler.jsonc: Cloudflare Workers assets + Worker deployment config.

Images

Images are served from Cloudflare R2 (not committed to this repo) via worker/index.ts, which keeps existing /img/... URLs working unchanged. Maintainers publishing new/updated images: see scripts/README.md.

Deploy

The site is exported as static assets and can be deployed to Cloudflare Workers with Wrangler:

pnpm run deploy

To upload a version without deploying it immediately:

pnpm run upload