# The studio

> What the Galerne studio does: live co-editing with presence, document lists with views and bulk actions, the editor and its panels, the media library, branches and reviews, the design tab, custom inputs and every settings page.

The studio is where people edit content and review what agents did. It lives at `https://studio.galerne.cloud`. Every change it makes goes through the same tools as the API and MCP, so permissions, plan limits, validation and the audit log are the same everywhere.

## Find your way

The sidebar follows the `structure` of your [schema](/docs/schema.md#studio-structure), or lists every type in config order. The project switcher and the branch switcher sit in the app bar: the branch you pick is the one every list and editor shows, and a link with `?branch=` opens another.

**⌘K** opens the command palette. Type to jump to a document, a type or a branch, create a document of any type, run the content checks on the current document or branch, or open a settings page.

The project home shows the activity of the project, branches waiting for review, the tasks assigned to you and a summary of the content checks.

## Document lists

Each type has a list with search, filters by status and by language, and an order. Save a set of filters as a named view to find it again; views are kept in your browser. Select several documents to publish, unpublish or delete them in one go. Types marked `orderable` get a manual order you set by moving documents up and down, stored in `_order`.

## Live co-editing

Several people edit the same document at once, on the same branch. Edits merge live, character by character in text and rich text, and block by block in blocks fields. Each person sees who else is in the document and which field they are in. Edits save as you type, and **⌘S** sends pending edits at once. Edits made offline stay in the browser and go out when the connection comes back.

When an agent or a script changes the document through the API or MCP, the open editors update with its change. A person whose role, branch or language rules do not allow writing sees the document read only, and so does everyone when the project's writes are paused.

## The editor

The form follows the fields of the type: every [field type](/docs/schema.md#field-types) has its input, rich text has a toolbar and embeds blocks, images have alt text, a caption, a hotspot and a crop, and references open a picker limited to the allowed types. The document menu publishes, unpublishes, [schedules](/docs/scheduling.md), duplicates and deletes.

Panels next to the form:

| Panel | What it shows |
|---|---|
| checks | Validation errors and content checks of this document, each linked to its field |
| comments | Comments and tasks on the document and its fields; see [comments and history](/docs/comments-history.md) |
| references | Documents that use this one, and documents it uses |
| history | The latest versions, with a link to the full history page, its field diffs and restore buttons |
| translations | For types with documents per language: each language, and translations whose source changed after them |

With a preview URL in the site settings, **preview** shows the site next to the form on the current branch, refreshed after each save. A click on a marked element of the page focuses its field. See [visual editing](/docs/visual-editing.md) and the [Next.js kit](/docs/nextjs.md#live-preview).

## Custom inputs

A field can use another input than the built-in one with `component` in `galerne.config.ts`:

```ts
excerpt: { type: 'text', component: 'character-count', componentOptions: { max: 160, multiline: true } },
brand: { type: 'string', component: 'color-swatches', componentOptions: { colors: [{ value: '#0B6E66', title: 'sea' }] } },
```

| Component | Options | What it shows |
|---|---|---|
| `character-count` | `max`, `multiline` | A text input with a live character count against `max` |
| `color-swatches` | `colors`: `{ value, title? }[]` | A row of swatches to pick a value from |

A custom input writes the whole value at once, so when two people edit that field at the same moment, the last one wins. An unknown name falls back to the built-in input with a short note.

## Media library

Drop files on the library to upload them, up to 200 MB each; the same file uploaded twice is stored once. Search by file name, title, alt text, credits and tags, and filter by tag and type, or show the files no document uses. Each file has a page with its details, the documents that use it, and a button to replace the bytes while keeping the id. See [media](/docs/media.md).

## Branches and reviews

**Branches** lists the open branches, those in review and those merged, with the promotions of the project. Each promotion can be rolled back from there. A branch's review page shows its changed documents with a diff per field, the schema deployed on it, conflicts with `main`, the content checks, comments and the review history, with **approve**, **request changes** and **promote**. See [branches and review](/docs/branches.md).

## Design tab

For sites made from the [site template](/docs/site-template.md), **design** frames the site's [design browser](/docs/design-browser.md) on the current branch, with a token editor next to it. Changes restyle the frame at once, and **save on a branch** commits them with `update_theme`.

## Settings

| Page | What it holds |
|---|---|
| general | Name, public reads, site URL and routes per type, `llms.txt`, Tramontane CDN purge, preview URL and secret |
| site | The [managed site](/docs/sites.md): create, refresh, git access, mirrors, delete |
| members | People, invitations, roles and limits per member; see [members and tokens](/docs/members.md) |
| agents and MCP | Agents, their rules and tokens, the kill switch, and how to connect an MCP client |
| API tokens | Project tokens with their scope and expiry |
| connected apps | MCP clients that signed in with OAuth, with **disconnect** |
| webhooks | Endpoints, filters, secrets and deliveries; see [webhooks](/docs/webhooks.md) |
| data sources | External APIs that fill documents; see [data sources](/docs/sources.md) |
| schema | The deployed content model and the schema history |
| cache | Cache lifetime and extra purges per type; see the [Next.js kit](/docs/nextjs.md#cache-settings-per-type) |
| usage and plan | Usage this month, the plan, invoices; see [billing](/docs/billing.md) |
| single sign-on | OIDC connections, domain verification, SCIM tokens; see [SSO and SCIM](/docs/sso.md) |
| audit log | Who did what, on Business |
| danger zone | Delete the project |

The palette also switches between the light and dark themes.
