Glyph docs

Glyph docs · v0.1

You arrived here with one of four jobs. The sidebar mirrors them; pick the one closest to yours.

Understand a concept

Explanation pages for the questions that start with why — the three modes, four CRDT subdocs, the operator contract, the run lifecycle.

Look something up

Reference catalogs auto-rendered from the canonical product files: ~50 operators, 7 trigger types, the node taxonomy, the glossary.

Learn by doing

Tutorials that take you from zero to a working flow without branching choices — the on-rails introduction.

Operate or develop

Admin-tier how-to recipes: ship a backend change, add a new operator, debug a stuck run, rotate a secret. Zitadel admin role required.

How these docs are organized

These docs follow Diátaxis: every page is exactly one of tutorial · how-to · reference · explanation. Mixing them is the cardinal sin we are trying not to commit, so each top-level sidebar section names its mode.

Two visibility tiers, decided by URL prefix:

• Public — concepts, glossary, the operator catalog, a single getting-started tutorial. Anyone can read.
• Admin — the entire engineering wiki: operate, develop, internals, ADRs. Anything under /docs/admin/* requires a Zitadel admin role and is gated at the edge by Caddy forward_auth against oauth2-proxy.

If you are signed in and see a 403 on an admin page, your Zitadel project role is missing admin. Ask the owner.

What Glyph is, in one paragraph

Glyph is a collaborative programmable whiteboard and a visual AI workflow builder. You compose flows on a real-time multiplayer canvas by chaining typed operators — LLMs, APIs, data transforms, triggers — and you press Run. Under the hood it is a Rust/Axum single binary serving an Axum HTTP API, a Yjs CRDT room hub, and a DAG executor; the frontend is React 19 + React Flow with four Yjs subdocs per document. It runs as a DJED Layer 2 cell behind shared PgBouncer, Redis, MinIO, Zitadel, and Caddy.