README

A Statamic 5 and 6 addon that serves VitePress-built documentation behind the Statamic Control Panel's authenticated routes.

Installation

1. Require the addon

composer require superinteractive/statamic-super-documentation

2. Install VitePress

npm install --save-dev vitepress

3. Build the documentation

npm run docs:build

4. Publish the config (optional)

php artisan vendor:publish --tag=super-documentation-config

Local Development

When developing this package with the Super Statamic Starter Kit source app, work from the package repository:

cd Packages/statamic-super-documentation

The Control Panel assets are powered by Vite. During development, run:

npm install
npm run build

Configuration

Published to config/statamic/super-documentation.php:

Writing Documentation

Documentation source files live at resources/docs/src/ (configurable). Add Markdown files following VitePress conventions.

Local preview

npm run docs:dev

Build for production

npm run docs:build

VitePress Base Path

The VitePress base in .vitepress/config.ts must match the Statamic CP route prefix. The default is /cp/documentation/. If your CP route is changed via the CP_ROUTE environment variable, update the base accordingly and rebuild.