> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vued.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mintlify Maintenance

> How agents should update this Mintlify docs site.

This docs directory is a Mintlify docs-as-code project.

## Local commands

Run from `web-client`:

```bash theme={null}
npm run docs:dev
npm run docs:validate
```

Or run directly from `web-client/docs`:

```bash theme={null}
npx mint@latest dev
npx mint@latest validate
```

## Mintlify MCP

This repo includes a local MCP manifest at `web-client/docs/.mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "Mintlify": {
      "url": "https://mcp.mintlify.com"
    }
  }
}
```

The Codex Mintlify plugin also registers the same server. After connecting OAuth in a new Codex thread, use the Mintlify admin MCP for dashboard-backed docs edits and PRs.

## Update workflow

1. Inspect `docs.json`, the relevant MDX page, and `openapi/vued-public-api.yaml`.
2. Update source API/SDK references first when behavior changed.
3. Keep `docs.json` navigation in sync with added, moved, renamed, or deleted pages.
4. Update `.mintlify/skills/vued-api-docs/SKILL.md` when docs structure or canonical sources change.
5. Run `npm run docs:validate`.
6. Use Mintlify MCP sessions for hosted project edits only after checking out a focused branch.

<Note>
  Mintlify's public docs search MCP for these docs will be available at the deployed docs domain's `/mcp` endpoint after the site is live and indexed.
</Note>