# Contentrain Studio Documentation

> Contentrain Studio is an AGPL-licensed, open-core, conversation-first CMS for managing structured content over Git. Connect a GitHub repo, define content models, edit through an AI chat agent or UI, and ship changes through review — with media, forms, CDN, webhooks, and APIs on the same `.contentrain/` contract used across the Contentrain AI ecosystem.

Full documentation as a single file (for LLMs): https://docs.contentrain.io/llms-full.txt

## About

Contentrain Studio connects to GitHub repositories and provides:
- AI-powered content operations via Claude (every paid plan gets the full model lineup — Haiku, Sonnet, Opus — through the Studio-hosted key; plans differ on monthly message quota and BYOA, not on which models are available)
- Four content model kinds: Collection, Singleton, Document, Dictionary
- 27 built-in field types
- Git-backed review workflow with branch diffs (cr/* → contentrain → main)
- Media library with image variants and blurhash (Enterprise Edition)
- Form submissions with approval workflow (Turnstile CAPTCHA)
- CDN delivery with API key management (Enterprise Edition)
- Outbound webhooks for content events (Enterprise Edition)
- Conversation API for programmatic chat (Enterprise Edition)
- MCP Cloud — a hosted HTTP MCP endpoint that lets external AI agents/IDEs operate on a project's content
- Two-tier role system (workspace: Owner/Admin/Member + project: Editor/Reviewer/Viewer)
- Open core model: AGPL core + proprietary Enterprise Edition (ee/)

This documentation site is itself built with Contentrain: its pages are `document` entries and its navigation is a `docs-nav` collection, all under `.contentrain/`.

## API Surfaces

- Public, versioned, key-gated APIs (stable external contract): `/api/{forms,media,cdn,conversation,mcp}/v1/...`
- Internal application API (cookie/session auth, not a stable contract): workspaces, projects, content, chat, branches, auth, webhook management

## Documentation Structure

- /guide/ — User guide (getting started, content management, features, administration)
- /developer/ — Developer docs (architecture, self-hosting, internals, API reference)

## Key Pages

- Getting Started: /guide/
- Quickstart: /guide/quickstart
- Core Concepts: /guide/concepts
- Content Models: /guide/content-models
- AI Chat: /guide/ai-chat
- Branches & Review: /guide/branches-and-review
- Billing & Plans: /guide/billing
- Account Settings: /guide/account-settings
- Connected Apps: /guide/connected-apps
- Troubleshooting: /guide/troubleshooting
- Self-Hosting: /developer/self-hosting
- Environment Variables: /developer/environment-variables
- API Reference: /developer/api-reference/
- MCP Cloud: /developer/mcp-cloud
- MCP Connector (Remote MCP OAuth): /developer/mcp-connector
- Architecture: /developer/architecture
- Field Types: /developer/field-types
- Roles & Permissions: /developer/roles-permissions
- Enterprise Edition: /developer/enterprise-edition

## Tech Stack

- Framework: Nuxt 4 (full-stack)
- UI: Radix Vue + Tailwind CSS 4
- Auth: Provider interface (default: Supabase Auth — GitHub/Google OAuth, magic link)
- Database: Provider interface (default: Supabase PostgreSQL + RLS)
- Billing: payment-plugin registry (Polar by default; Stripe supported)
- AI: Claude API (Haiku 4.5, Sonnet 4.6, Sonnet 5, Opus 4.8 models)
- Content: Contentrain format (.contentrain/ directory in Git repos)

## Licensing

- Core: AGPL-3.0 (with LICENSE-EXCEPTIONS §7 additional terms)
- Enterprise (ee/): Proprietary
- Self-hosted first, open-core model

## Contact

- GitHub: https://github.com/Contentrain/studio
- Website: https://contentrain.io