Runic
SHARE

Read-only links that show the current diagram

Two clicks mint a /s/ link anyone can open. It renders what the document says right now, and Revoke kills it on the spot.

Try it free →Read the docs

What viewers see

The shared page has a navy header with 'Runic / <name>', a 'Shared · read-only' chip and a 'Try Runic' button. Under it sits the diagram with zoom controls (25% to 250% for a process, 50% to 150% for a sequence diagram), the Flow direction toggle for processes, hover highlighting and an Export menu with every format. There is no editor, no text field, and step icons cannot be changed.

An open page checks the source every 45 seconds. When the name or text has moved on, a banner says 'This flow was updated after you opened it.' with a 'Show the latest version' button. Nothing swaps under the reader until they click. Pressing it redraws the diagram from the new text and updates the header name and the export, on a process flow and on a sequence diagram alike — no page reload.

Cross-document links are inert in the shared view. A .go or .do card does not jump to another document, because that document was not shared.

Creating and revoking

Sharing needs a signed-in account, because the link resolves on the server; without one the menu says 'Sharing needs an account — sign in so your flows live on the server.' A document that has not reached the server yet answers 'This document hasn’t synced yet — try again in a second.' Creating a link is idempotent: the button returns the existing token if the document already has one, and copies the URL to your clipboard the moment it exists. Pending edits are flushed first, so the link shows what you see.

Revoke deletes the token; the menu confirms 'Link revoked — it no longer works.' The next visit shows 'This link doesn't exist', and any embed built from the same token stops too. Creating a link again mints a fresh token, so old copies of the URL stay dead. Deleting the document kills its link at once.

Limits and gotchas

You need write access to the document to create or revoke its link; team viewers see 'You have view-only access — ask an editor to share it.' Link creation is rate-limited to 60 per hour per account, processes and sequence diagrams together. The Share menu hides while a chat proposal is being previewed on the flow, because the link always reflects the saved document.

A share link is 'anyone with the link', not 'anyone who searches'. Share pages send noindex headers and robots.txt disallows /s/. The same token also serves a public JSON endpoint at /api/shared/<token> with the document's kind, name, text and last-updated time, so treat the URL like the document itself.

How to use it

  1. Open the document
    Pick the process or sequence diagram in the sidebar. The violet Share button sits at the top right of the diagram pane.
  2. Click Share
    The menu opens with the sharing section on top and the Export items underneath.
  3. Click Create share link
    The button reads 'Creating link…' while Runic saves pending edits and creates the token, then shows the URL in a read-only field and copies it. The note reads 'Copied to your clipboard — paste away. Anyone with the link can view — not edit.'
  4. Paste it anywhere
    Use Copy if you need the URL again. Clicking into the field selects the whole link.
  5. Revoke when the audience changes
    Click Revoke in the same menu. The menu confirms 'Link revoked — it no longer works.'

Commands & shortcuts

ShareMenu on the diagram pane; sharing on top, Export items below
Create share linkMints or returns the document's /s/<token> URL and copies it
CopyCopies the link again
Copy embedCopies an iframe snippet pointing at /embed/<token>
RevokeDeletes the token; the link and its embeds stop working
Show the latest versionBanner button on an open share page after the document changed
share_document (MCP)Returns the /s/ link and the /embed/ URL for a document by id or name

Tips

  • Reloading the editor resets the menu to 'Create share link', but clicking it again returns the same URL. You only get a new token after Revoke.
  • Viewers can flip a process between top-down and left-to-right and export PNG, SVG, text or Markdown from the Export menu on the shared page.
  • Sharing a process does not share the processes it calls. Share each one separately if the reader needs to follow the .do and .go lines.
  • Ask Claude for the link: the MCP share_document tool creates or returns it without opening the app.

Questions

Can a viewer edit or comment?

No. The shared page has no editor and no comments. The header says 'Shared · read-only' and there is no text field on the page.

Does the link update when I keep editing?

Yes. Each load renders the current text, and an open page checks every 45 seconds and offers 'Show the latest version'; pressing it redraws the open page for both kinds of document.

Can I share a document a teammate created?

Only with editor or owner access to it. Viewers see 'You have view-only access — ask an editor to share it.'

Is the link password protected?

No. Anyone with the URL can open it. Revoke it when the audience should lose access.