GlyphfieldDocs
Documentation/System reference

Agent integration

Connect a language model or coding agent to Glyphfield through the discovery routes, the generation API, the Studio Browser API and the Markdown docs.

Maintained with source

Glyphfield is an open-source brand design studio. It gives coding agents and language models three interfaces. The HTTP routes describe the product and generate files. The Studio Browser API (window.glyphfield.studio) operates the open Studio in a browser. The documentation is available as Markdown. An agent can read the whole product contract from these interfaces without parsing the application's JavaScript.

Design Lab with shader library, composition canvas, inspector, and layer dock
Design Lab in the browserCanvas · WebGL · source · export
Animation editor with sequence, timing, material, and output controls
Animation editorFrames · audio · GIF · MP4

Discovery routes

RouteReturns
/llms.txtA short guide for language models that routes each task to an interface
/llms-full.txtEvery documentation page in one text file, built from the current MDX
/docs/<path>.md or /api/docs/<path>One documentation page as processed Markdown
/api/agentThe versioned agent manifest with policies, resources, the generation contract and the Browser API contract
/openapi.jsonThe OpenAPI 3.1 document for the HTTP routes
/api/catalogStudio tools, resource URLs, and summaries of the shader and tactile surface libraries
/api/labsEvery Studio tool with its capabilities and agent access
/api/materialsEvery shader material and image effect with attribution, palettes, look presets and controls
/api/identitiesThe nine built-in brand identities
/api/elementsThe brand element templates with their IDs, sizes and formats
/api/generateThe generation contract (GET) and the generation endpoint (POST)
/api/brand/validateThe BrandIdentity JSON Schema (GET) and stateless identity validation (POST). See Brand setup with an agent
/api/brand/kitBrand kit token files and brand.md rendered from an identity (POST)
/api/search?query=<text>Ranked documentation search results
/studioThe browser workspace that registers the Browser API
skills/ in the repositoryFive installable Agent Skills for composition, HTTP generation, Studio operation, export and brand setup

Interfaces

HTTP generation

POST /api/generate returns template SVGs, background SVGs, element briefs and apply-ready Design Lab documents. The same request always returns the same result, and no browser is involved. See Generation API.

Studio Browser API

Open /studio in a browser the agent controls when the result needs Canvas, WebGL or WebGPU rendering, local fonts or images, visual placement, PNG or JPG rasters, GIF or MP4 encoding, or Lottie. The Browser API reads and applies the active tool's source. It lists and operates the controls in the active tool's workspace, and it exports the same files as the UI. See Browser-agent workflow.

Markdown documentation

Read /llms.txt to route a task. Load /llms-full.txt for the complete product model, or one page as Markdown when the task needs only one topic. These routes and the human documentation come from the same MDX source.

Use the smallest interface that can produce the requested artifact. The interfaces also combine: an HTTP design-sequence document is rendered and exported through the Browser API.

Agent workflow

  1. Read the live contract and catalog IDs.
  2. Read the current source before changing an open artifact.
  3. Keep unknown fields and apply the smallest change through the tool's validator.
  4. Read the state again after applying it.
  5. Inspect the rendered output when appearance matters.
  6. Check the saved file or the returned Blob. A successful request or click does not prove that the file exists.

Authentication

The public agent routes do not require authentication. Do not send an Authorization header. Read /api/agent and GET /api/generate at the start of each task, because schemas can change between releases.

Install the Glyphfield Skills, then continue with Choose an agent interface, Connect an agent and Agent recipes.

On this page