docs menu

The studio

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, 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 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, duplicates and deletes.

Panels next to the form:

PanelWhat it shows
checksValidation errors and content checks of this document, each linked to its field
commentsComments and tasks on the document and its fields; see comments and history
referencesDocuments that use this one, and documents it uses
historyThe latest versions, with a link to the full history page, its field diffs and restore buttons
translationsFor 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 and the Next.js kit.

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' }] } },
ComponentOptionsWhat it shows
character-countmax, multilineA text input with a live character count against max
color-swatchescolors: { 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.

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.

Design tab#

For sites made from the site template, design frames the site's design browser 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#

PageWhat it holds
generalName, public reads, site URL and routes per type, llms.txt, Tramontane CDN purge, preview URL and secret
siteThe managed site: create, refresh, git access, mirrors, delete
membersPeople, invitations, roles and limits per member; see members and tokens
agents and MCPAgents, their rules and tokens, the kill switch, and how to connect an MCP client
API tokensProject tokens with their scope and expiry
connected appsMCP clients that signed in with OAuth, with disconnect
webhooksEndpoints, filters, secrets and deliveries; see webhooks
data sourcesExternal APIs that fill documents; see data sources
schemaThe deployed content model and the schema history
cacheCache lifetime and extra purges per type; see the Next.js kit
usage and planUsage this month, the plan, invoices; see billing
single sign-onOIDC connections, domain verification, SCIM tokens; see SSO and SCIM
audit logWho did what, on Business
danger zoneDelete the project

The palette also switches between the light and dark themes.