Getting Started
Set up Groo AI for your documentation in 5 minutes.
Prerequisites
- A GitHub repository with documentation
- A Groo account at accounts.groo.dev
1. Create a Project
- Go to the Groo AI Dashboard
- Click New Project
- Enter a name for your project
2. Connect Your Repository
Option A: Public Repository
Enter your repository URL directly:
https://github.com/your-org/your-docs
Option B: Private Repository
- Click Connect GitHub
- Install the Groo GitHub App
- Grant access to the repositories you want to index
- Select your repository from the list
3. Configure Content Settings
| Setting | Description | Example |
|---|---|---|
| Content Type | How your docs are structured | Markdown Site or Raw Files |
| Content Path | Folder containing docs | docs/ or content/ |
| Site URL | Your documentation website | https://docs.example.com |
| Exclude Patterns | Files to skip | **/node_modules/** |
Framework Detection
Groo AI auto-detects common frameworks (Docusaurus, VitePress, etc.) and pre-fills sensible defaults.
4. Trigger Indexing
- Click Create Project
- Groo AI will find the latest tag in your repository
- Indexing starts automatically
- Wait for status to show Ready
5. Test Your Setup
Once indexed, test in the dashboard:
- Go to Retrieval tab - search for a topic
- Go to Chat tab - ask a question
6. Integrate Into Your Site
React SDK (Recommended)
npm install @groo.dev/ai-react
import { Chat } from '@groo.dev/ai-react'
function App() {
return <Chat apiKey="your-api-key" />
}
See React SDK for full documentation.
REST API
Use the API directly for custom integrations.
Getting an API Key
- Go to accounts.groo.dev
- Navigate to API Tokens
- Create a token with your project ID in
app_data
{
"app_data": {
"projectId": "your-project-id"
}
}
Keeping Docs Updated
Groo AI monitors your repository for new tags:
- Automatic Detection: Webhook notifies when a new tag is pushed
- Manual Check: Click "Check for Updates" in the dashboard
- Re-index: Click "Update" when a new version is available
Next Steps
- Dashboard Guide - Learn all dashboard features
- React SDK - Integrate chat into your site
- API Reference - Build custom integrations