Developer Guide

Welcome to the Contentrain Studio developer documentation. This section covers the technical details you need to deploy, extend, and contribute to Studio.

Quick Links

Topic	Description
Architecture	System design, provider pattern, stack decisions
Self-Hosting	Deploy Studio on your own infrastructure
Environment Variables	Complete configuration reference
API Reference	All REST API endpoints
Field Types	27 supported content field types
Provider Interfaces	AuthProvider, DatabaseProvider, etc.
Roles & Permissions	Two-tier role system and tool access matrix
Contributing	Development setup and PR process

Tech Stack

Layer	Technology
Framework	Nuxt 4 (full-stack, SSR)
UI	Radix Vue + Tailwind CSS 4
Auth	Provider interface (default: Supabase Auth)
Database	Provider interface (default: Supabase PostgreSQL + RLS)
AI	Claude API (Haiku, Sonnet, Opus)
Content	Contentrain format (.contentrain/ directory)
Icons	Annon custom set via @iconify/tailwind4
Package Manager	pnpm

Open Core Model

Studio is licensed under AGPL-3.0 with an enterprise extension:

studio/
├── app/          # AGPL — core application
├── server/       # AGPL — server routes & providers
├── ee/           # Proprietary — enterprise features
└── ...

The AGPL core is a fully functional product. Enterprise features (ee/) add advanced capabilities like SSO, approval chains, audit logs, and white-label branding. See Enterprise Edition for the full boundary definition.

Getting Started

1. Clone the repository and install dependencies:

git clone https://github.com/Contentrain/studio.git
cd studio
pnpm install

2. Copy the environment template and configure:

cp .env.example .env

3. Start the development server:

pnpm dev

See Self-Hosting for production deployment with Docker.