npm i -g mint

# Clone the repository
git clone https://github.com/rejoicehub/callintel-livekit.git
cd callintel-livekit/docs

mint --version

mint dev

mint dev --port 3333

Port 3000 is already in use. Trying 3001 instead.

mint build

# Install serve to test locally
npm i -g serve

# Serve the built documentation
serve dist

# Visit http://localhost:3000

# Create a new guide
touch guides/services/new-service.mdx

---
title: "Service Name"
description: "Brief description"
---

{
  "navigation": {
    "tabs": [
      {
        "tab": "Guides",
        "groups": [
          {
            "group": "Services",
            "pages": [
              "guides/services/new-service"
            ]
          }
        ]
      }
    ]
  }
}

<Card
  title="Title"
  icon="icon-name"
  href="/path"
>
  Description
</Card>

<Columns cols={2}>
  <Card>...</Card>
  <Card>...</Card>
</Columns>

<Note>Important information</Note>
<Warning>Warning message</Warning>
<Tip>Helpful tip</Tip>
<Check>Success message</Check>

<CodeBlock title="Example" language="python">
  code here
</CodeBlock>

<Expandable title="Click to expand">
  Hidden content
</Expandable>

mint lint

mint validate

{
  "colors": {
    "primary": "#16A34A",
    "light": "#07C983",
    "dark": "#15803D"
  }
}

{
  "navigation": {
    "global": {
      "anchors": [
        {
          "anchor": "GitHub",
          "href": "https://github.com/rejoicehub/callintel-livekit",
          "icon": "github"
        }
      ]
    }
  }
}

# Good: Clear, runnable example
from Service.AgentService import AgentService

service = AgentService()
agent = await service.create_agent({
    "name": "Support Agent",
    "ai_provider": "gemini"
})

git add docs/
git commit -m "Update documentation"
git push origin main

{
  "navbar": {
    "primary": {
      "type": "button",
      "label": "Get Started",
      "href": "https://yourdomain.com/guides/getting-started/quickstart"
    }
  }
}

# Clear cache
rm -rf .next

# Restart server
mint dev

# Find process using port 3000
lsof -i :3000

# Kill process
kill -9 <PID>

# Restart
mint dev

# Check for syntax errors
mint lint

# Validate configuration
mint validate

# Look for missing imports or broken links

# Build production version
mint build

# Deploy to your hosting provider
# (See your deployment configuration)

# Create a branch for documentation updates
git checkout -b docs/update-guides

# Make changes
vim guides/services/new-service.mdx

# Commit changes
git add docs/
git commit -m "docs: add new service guide"

# Push and create PR
git push origin docs/update-guides

docs: add API authentication guide
docs: fix typo in quick start
docs: update Docker deployment instructions

npm mint update

mint broken-links