Presenting & sharing
Explain a run in Present mode, export a recorded sequence diagram or animated journey GIF, or record a local video. Publication and sharing controls are described separately below.
Current alpha availability: Present mode and local recording, sequence diagrams, and journey GIF export are available. Run and diagram publishing, share-link creation, and protected exports are disabled in the current editor. Contract Studio exports are separate and remain available after approval. The publication sections below describe the stored profiles and access rules, not controls you can use in the current alpha UI.
Present a completed run
Present becomes available when a playback artifact is loaded. It switches to a read-only view that follows the same event story as the timeline. You can move through chapters or events, inspect the narrative or transcript, jump to a problem, change playback speed, and use fullscreen without changing the diagram.
- Run the journey you want to explain.
- Review the timeline first and select the part of the story that matters.
- Select Present. Use the playback controls to move through the run at the pace of the conversation.
- Close Present mode to return to the editor in the same diagram.
Presentation is a local playback surface, not a publication and not a saved share. Diagram links are opaque boundaries here: you can see their label and run note, but presentation has no cross-diagram navigation.
Export a journey GIF
Run the selected journey, then choose Export GIFbeside Present. A moving blob follows each recorded connection, including requests, replies, database calls, and queue traffic. The preview includes the journey title and a short caption for the current connection.
- Choose Compact under View for service-type icons and readable labels, or keep Detailed for the full component cards. Both views animate the same recorded connections.
- Choose Journey only to fit the components and connections the run visited, or Whole diagramto keep the entire architecture visible while animating that journey.
- Choose an 800 px or 1200 px maximum dimension and a speed. The camera stays fixed and the diagram keeps its proportions.
- Select Download GIF. Generation happens locally with progress and cancellation, without screen-capture permission.
GIFs are silent, have an opaque background, and loop continuously at 20 frames per second with a one-second pause between loops. Timing illustrates the route; it does not represent latency or concurrency. Only the selected run’s actual branch is included. Run another journey variant to export a different outcome.
Run journey first means a completed run is missing or no longer matches the current graph and journey. Exports are limited to 60 seconds and 25 MiB. Choose a faster speed, a smaller image, or a shorter journey when a limit is exceeded.
Export a recorded sequence diagram
Run a journey, then open Options and choose Sequence diagram in the Export section. Preview the recorded interactions, copy Mermaid source, or download an editable .mmd file or standalone SVG. Generation stays in your browser.
Choose all requests or one request with its descendants. An optional inclusive message range is applied after request selection; excerpts are marked in both formats. Structural notes add cache outcomes, committed database operations, retry scheduling, timeouts, queue outcomes, and terminal status.
This is one recorded execution. Each delivered interaction stays in order, including repeated retries and self-messages. Independent branches can execute concurrently; their observed delivery order does not establish causality or latency. No alternate branches, parallel blocks, or retry loops are inferred. Activation bars appear only when both ends of a synchronous call can be paired unambiguously.
Failed, guarded, and cancelled artifacts are marked as partial runs. Missing responses are never added. Editing the diagram or journey before opening export requires a fresh run. An open dialog keeps its captured source even if the editor changes.
Authored component and connection labels are included. Runtime payloads, state values, cache keys, and free-form event summaries are excluded. Check authored labels before sharing a file. Exports include source hashes, the journey revision, and exporter version so reviewers can identify the captured run.
Each export allows 20 participants, 200 messages, and 100 structural notes. Narrow the request or range, or disable notes, if a limit is reached. Empty selections cannot be downloaded. Clipboard failure leaves selectable source in the Mermaid source tab. The SVG download includes the entire diagram, even when the preview scrolls.
Open SVG in a browser or vector editor. Open .mmd as text to edit it, or render it in a Mermaid-compatible editor. When using a hosted Mermaid viewer, the source you paste is subject to that viewer’s data handling.
Record the presentation
Presentation can record the selected browser tab or display as a local WebM or MP4 video, depending on browser support. The browser asks for display permission; optional microphone narration asks for a separate microphone permission.
- Open Present and choose the recording control.
- Select the current tab or display in the browser permission prompt. Enable microphone narration only if you want it.
- Recording restarts playback from the beginning and stops automatically at the end. You can also stop it manually. Graphrun downloads the video; it does not store the recording as a publication or share it.
If microphone permission is denied or unavailable, recording continues without narration. Ending display sharing after recording has started finalizes the captured video. Declining display access, ending it before recording starts, or an unsupported recorder prevents capture. While recording is active, Exit is blocked.
Publication profiles (when enabled)
The publication system stores a separate immutable bundle. Before it is stored, Graphrun explains what will be included and what will be left out. Review that summary every time; the profiles have different privacy and playback behavior.
| Profile | Stores | Playback |
|---|---|---|
| Diagram only | Topology, labels, types, groups, layout, and connection identity. No journey, configuration, descriptions, run, payload, state, or provider locator. | Static; no playback or regeneration. |
| Transcript-only exact | Topology plus exact event order, location, lineage, typed redacted summaries, and safe outcome counts. Journey, fixtures, settings, payloads, state, and raw summary strings are omitted. | Pinned exact story; regeneration is disabled. |
| Redacted exact | An exact run after the selected redaction or samples-only value policy. The dialog explains which value categories remain. | Pinned exact story; regeneration is disabled. |
| Full exact | The complete graph and configuration, journey inputs/fixtures/variables/limits, and exact run events, payloads, state timeline, summaries, and reproducibility metadata. | Pinned exact story; requires an approved private run. |
| Full regenerate | Complete graph and journey sources, but no approved run or stored run tables. | Intended for regeneration from source with supported engine and serializer versions. Protected playback is not enabled yet. |
A completed-run profile is offered only when the run matches the current saved graph and compatible journey hashes. Full exact also stores an approved private run. Full regenerate requires the saved graph and journey sources, but does not need a completed run. The current alpha editor exposes none of these publication actions.
The transcript-only option keeps the diagram structure, labels, and event order needed to tell the story. It leaves out journey input, component settings, stored state, and raw values.
Share-link access rules
- Private workspace link
- The viewer must sign in and still belong to the workspace.
- Unlisted link
- Anyone holding the high-entropy bearer token can resolve the manifest. Treat the link like a secret and send it only through an approved channel.
When link creation is enabled, it requires a stored immutable bundle, an access mode, and a transcript-download permission. The plaintext token is shown once; Graphrun stores only a keyed digest, and source IDs and storage locations are not placed in the URL or manifest.
Current share viewing resolves a safe manifest: access mode, bundle mode, hash prefix, expiry, playback policy, and transcript-download permission. Protected playback and artifact-byte delivery are not enabled yet, so a viewer does not receive the diagram, transcript, or raw values from the share page.
Management and protected exports (when enabled)
The gated share-management surface lists safe metadata such as access mode, publication mode, bundle hash, last-use count, expiry, and permitted actions. Revoking a link stops future use. Rotating a link invalidates its old token and returns a replacement token to copy once.
The gated protected-export flow requests an artifact from a stored publication as PNG, SVG, or canonical JSON; image scale is 1× through 4× and does not apply to JSON. The renderer uses the stored immutable bundle, not the live draft. Jobs can be queued, running, cancelled, retried after a failure, or downloaded after success. A retry is limited to four attempts, and completed artifacts expire after seven days.
The alpha switch hides publication dialogs, link creation, protected export panels, and the Shares and Exports inventory buttons. These are not alternate routes around the disabled controls. Viewers cannot fork or export a publication.
Before sharing, check the labels and event summaries as carefully as the access setting. A safe link cannot make sensitive words inside the published content safe.
When an action is unavailable
| What you see | What to check |
|---|---|
| Present is disabled | Run the selected journey and wait for a playback artifact. A saved graph alone is not a presentation. |
| Publish, Shares, or Exports is missing | These distribution controls are disabled in the current alpha editor. Rerunning or saving the diagram will not enable them. |
| Share is unavailable | The token may be invalid, expired, revoked, rate-limited, or private to a workspace you cannot access. Sign in and confirm active membership for a private link. |
| Existing protected export fails or expires | Retry a failed job before the four-attempt limit. Download a successful artifact before its seven-day retention window ends. |