# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is a Mintlify-based documentation site for Airia, a platform for building and deploying AI agents. The repository contains MDX documentation files organized into several main sections:

- **User Guide** - End-user documentation for Airia Chat
- **Administrator Guide** - Account settings, billing, policies, and on-premise setup
- **Building & Deploying Agents** - Core agent development workflow and deployment options
- **Feeds & Monitoring** - Activity feeds and monitoring capabilities
- **Integrations** - Tools and data source connectors
- **Developer Hub** - SDK and development resources

## Development Commands

### Local Development
```bash
# Install Mintlify CLI globally
npm i -g mintlify

# Start local development server
mintlify dev

# Re-install dependencies if dev server fails
mintlify install
```

### Publishing
Changes are automatically deployed to production when pushed to the main branch via GitHub App integration.

## Architecture & Structure

### Configuration
- `docs.json` - Main Mintlify configuration file defining navigation, theming, and site structure
- `custom.css` - Custom styling overrides
- Navigation is organized into tabs with nested groups and pages

### Content Organization
- **MDX Files** - All documentation content is in `.mdx` format supporting Markdown with React components
- **Images** - Stored in `Images/` subdirectories within each section
- **Snippets** - Reusable content blocks in `/snippets/`

### Key Directories
- `/admin-hub/` - Administrator documentation
- `/building-and-deploying-agents/` - Agent development guides
- `/integrations/` - Tools and connector documentation
- `/airia-chat/` - User-facing chat interface docs
- `/feeds/` - Monitoring and activity feed docs
- `/developers-hub/` - SDK and API documentation

### Navigation Structure
The site uses a tab-based navigation system defined in `docs.json` with:
- 8 main tabs (Home, User Guide, Administrator Guide, etc.)
- Nested groups within each tab
- Icon assignments for visual organization
- Hierarchical page structure supporting nested groupings

## Content Guidelines

- Documentation follows Mintlify MDX format
- Images should be optimized and stored in appropriate `Images/` subdirectories
- Use consistent naming conventions (kebab-case for files)
- Navigation changes require updates to `docs.json`