docs-v2

This is a monorepo for hosting the content for the documentation of various projects in Auth0.

We use Mintlify for our documentation needs.

Directories

• main: Main Documentation for Auth0: https://auth0.com/docs
  • Contains the primary Auth0 documentation content
  • Includes docs/, snippets/, and ui/ subdirectories
• auth4genai: Documentation for Auth0 for AI Agents features in Auth0: https://auth0.com/ai/docs
  • Contains content for AI-specific Auth0 features
  • Includes sections for quickstart guides, integrations, SDKs, MCP, and more
• ui: Shared UI components and tooling
  • React/Vite-based component library used across documentation sites

Local Development

Use the Mintlify CLI to preview and edit documentation locally.

Prerequisites

• Node.js v19 or higher

Installation

Install the Mint CLI globally:

npm i -g mint

Or using pnpm:

pnpm add -g mint

Note for VPN Users

When running mint dev for the first time, you'll need to disable your VPN to allow the framework to download. After the initial download completes, you can re-enable your VPN for subsequent runs.

Running the Dev Server

1. Navigate to the documentation folder you want to work with (where the docs.json file is located):

   cd main  # or cd auth4genai

2. Start the development server:

   mint dev

3. Open your browser to http://localhost:3000 to view the local docs

Useful Commands

• Update the CLI: mint update or npm i -g mint@latest
• Find broken links: mint broken-links
• Check accessibility: mint a11y
• Custom port: mint dev --port 3333

For more details, see the Mintlify CLI documentation.