Walk readers through your Mermaid diagram, one step at a time.

Add a few lines of timeline after the diagram to decide what each step shows, hides or highlights. The diagram and its walkthrough live in one text document: paste it into the Playground and it plays.

Plays in your browser, with no package to install.

how-it-works.srn+ marks the lines you add
flowchart TB
%% Your Mermaid diagram, not a character changed
Idea([Describe your flow]) --> Write[Skill writes the .srn]
Mermaid([Existing Mermaid diagram]) --> AddTimeline[Skill adds a timeline]
subgraph Studio [Playground]
Theme[Pick a theme] --> Tune[Tune the theme]
end
Write --> Theme
AddTimeline --> Theme
Tune ==> Play((Play))
Tune --> PPT[(Export PPT)]
Tune --> Image[/Export image/]
timeline:
%% One line is one step. Click a line to jump to it.
What readers see
0 / 8Two ways in: a description, or a diagram you have

One document, for three people.

Whoever writes the walkthrough, whoever watches it, and whoever builds the player into a product all get the same .srn.

Writing it

Your diagram and walkthrough, in one text document.

Draw in Mermaid, order the steps with a timeline. It's all plain text: keep it next to your code, review and change it in Git.

  Bank --> Done[Order placed]
+ Bank -.-> Retry[Retry payment]
  …
+   highlight Retry outline
Learn the timeline syntax

Watching it

Paste it in and play it at your own pace.

Whoever gets it pastes the text into the Playground, then steps forward, back and between routes. Nothing to install, no dev environment.

← PreviousNext →success ▾Full diagram
Open the Playground

Building it in

An open-source engine for your own app.

siren-core draws the document as SVG; siren-board is a ready-made player with step buttons, autoplay and route switching. MIT licensed.

 npm install siren-core siren-board
API docs

One line, one step. Four actions.

Each timeline line is a step: it names what moves on that step. List several on one line, separated by commas.

  • Targets are the diagram's ids: a node is Pay, an edge is Cart-Pay
  • An element with an enter stays hidden until that step
  • An id that doesn't exist is reported with its line
The full timeline syntax
ActionWhat it doesExample
enterThe element appears on this step: fade, or slide in from any sideenter Pay fade
exitThe element leaves on this step; its space is kept, so nothing else movesexit Retry slide-left
highlightHighlights the element: outline thickens its border, glow lights it uphighlight Bank glow
unhighlightTakes the highlight offunhighlight Bank

One diagram, different routes.

Name your timelines: one for a payment that goes through, one for a retry. The diagram is drawn once; readers pick a route in the player.

timeline success:  …  exit Retry fade, exit Bank-Retry fade, highlight Done outline, unhighlight Banktimeline retry:  …  exit Done fade, exit Bank-Done fade, highlight Retry outline, unhighlight Bank

flowchart sequenceDiagram classDiagram
stateDiagram erDiagram gantt

Six common Mermaid diagrams

Keep the diagram you have. Syntax Siren doesn't support yet is reported with its line, never drawn wrong.

--siren-node-fill: #f3efff;
--siren-highlight-color: #0d9488;

Restyle it with CSS

Colours, lines and type are all --siren-* design tokens: override them in your own CSS for your own theme.

~/.claude/skills/siren/SKILL.md

Let AI write it

Install Siren's agent skill and AI agents such as Claude Code draw the diagram, script the timeline, and check on their own that it renders.

Writing Siren with AI

Make your diagram follow your story.