Studio guide

Graxeon Studio is the full authoring environment. You create schemas, populate collections with items, upload files, and manage who has access. It runs at http://localhost:5056 by default.

Collections

A collection is the top-level container for your knowledge. Think of it as a project or a database — it holds all the items (nodes) and the schema that defines their structure.

To create a collection:

1. Click New collection on the dashboard.
2. Enter a name and optional description.
3. Click Create. The collection is immediately available.

Each collection is stored as one or more .kgl files in your configured storage backend (MinIO by default).

Schema

The schema defines the types of items in your collection and the fields each type can have. Every field has a name and a type that determines how it's rendered and validated.

Creating a type

1. Open a collection and go to the Schema tab.
2. Click New type and enter a name (e.g. Article).
3. Add fields: click Add field, enter a name, and choose a type.
4. Mark fields as required if they must always have a value.
5. Save the schema.

Field types

Studio supports the following field types:

• Text — single-line string
• Rich text — Markdown content
• Number — integer or decimal
• Currency — numeric value displayed with currency symbol
• Date — calendar date (YYYY-MM-DD)
• Date & Time — date and time (ISO 8601)
• Checkbox — true / false toggle
• URL — web address
• Email — email address
• Phone — phone number
• Image — uploaded image file
• Video — uploaded video file
• File — any uploaded file
• Markdown file — uploaded Markdown document

Items

Items (called nodes in the KGL format) are the individual records in your collection. Each item has a name, one or more types, structured fields, and an optional rich text body.

Creating an item

1. Open a collection and go to the Items tab.
2. Click New item.
3. Enter a name — this is the unique identifier for the item.
4. Choose a type from the schema.
5. Fill in the fields and write the body text in the editor.
6. Changes save automatically.

Body editor

The item body is a full Markdown editor powered by Monaco (the same editor as VS Code). Use the toolbar for common formatting, or write Markdown directly. A live preview shows the rendered output alongside the editor.

Linking items

Any item can link to any other item. Links are stored as @link directives in the KGL file and are displayed as navigable relationships in both Studio and Explorer. You can link to items in the same collection or across collections.

Tags

Tags are free-form labels that can be added to any item for filtering and discovery. They are stored as comma-separated values in the @tag field.

Files and assets

Image, video, and file fields store assets in object storage (MinIO by default). The field value in the KGL file is a graxeon-asset:// URI — the actual binary is kept separate from the text representation.

To upload an asset, click the upload button on any image, video, or file field in the item editor.

Access management

Each collection has its own access list. Users can be assigned one of three roles:

• Viewer — read-only access via Explorer. Can browse, search, and view items but not edit them.
• Editor — can add and update items in Explorer, but cannot change the schema or manage access.
• Owner — full access including schema management and access control. The creator of a collection is automatically an owner.

To invite a user, go to the collection's Access tab and enter their email address.