Examples

The grafli source tree ships an examples/ directory with .grafli files you can open and explore.

Architecture demo

examples/architecture.grafli exercises the full feature surface in a single diagram:

• Visible nesting containers for layered architecture (frontend, API, core, data, observability)
• Semantic edge labels (call:, data:, event:, state:, verify:, risk:)
• Code-mode notes attached to specific services
• Tasks (T:), questions (Q:), and discussion notes
• A linked markdown resource (examples/architecture-res/graphql.md)

Open it from a clone:

git clone https://github.com/MisterGC/grafli.git
grafli grafli/examples/architecture.grafli

Bookmarks & flows demo

examples/flows-demo.grafli is a small six-service architecture wired up with bookmarks and two flows — a guided tour through the system and a security-path walkthrough. Open it, toggle the side panel with \, switch to the Flows tab, and play a flow; press F5 to present one fullscreen, or export it to a slide PDF:

grafli export grafli/examples/flows-demo.grafli tour.pdf --flow tour

See Bookmarks & flows for the full feature.

Try it yourself

The format is small enough that the fastest way to learn is to read a file and edit it. Start from the example, then:

1. Press n to drop a new box.
2. Press Ctrl+l to spawn a connected box to the right.
3. Press e on an arrow and prefix the label with call:, data:, or event: to see edge chips render live.

For more on annotations, see Text annotations.