name: setup-docs description: > Run the docs site, blog, or Storybook locally. Use when contributing to documentation, previewing blog posts, or developing UI components in isolation. Not needed for regular frontend development. allowed-tools: Bash
Local Docs, Blog & Storybook Setup
These are all independent of the main dev server — you don't need the database or Auth0 configured to run any of them. Just make sure dependencies are installed first (pnpm install --filter frontend from the repo root).
All commands run from the frontend/ directory.
Docs site
VitePress docs served at http://localhost:5173:
cd frontend && pnpm docs:dev
Build and preview the production output:
cd frontend && pnpm docs:build && pnpm docs:preview
Blog
VitePress blog served at http://localhost:5174:
cd frontend && pnpm blog:dev
Build and preview:
cd frontend && pnpm blog:build && pnpm blog:preview --port 5174
Storybook
Component development and documentation, served at http://localhost:6006:
cd frontend && pnpm storybook
Build static Storybook:
cd frontend && pnpm storybook:build
Troubleshooting
- Port already in use — kill the process using the port or change it with
--port <N> - Missing dependencies — run
pnpm install --filter frontendfrom the repo root first - Storybook build errors — usually a component import issue; check the console output for the failing story