Skip to content
Vivek Sarin edited this page Nov 20, 2026 · 7 revisions

Welcome to the FlowMotion Wiki

FlowMotion turns a short text description of a system, a process, or a flow of data into a diagram that moves. Requests travel along the arrows, each step takes its time, and you can see where work waits. FlowMotion works inside Obsidian and does not need an internet connection.

What you can do with FlowMotion

  • Draw flowcharts, sequence diagrams, process workflows, state diagrams, mind maps, Gantt charts, and data models.
  • Play a diagram to see how work moves from one step to the next.
  • Save a diagram in its own file and show it in as many notes as you need.
  • Animate drawings made in draw.io.
  • Choose the size, the screen mode, and the background of each diagram.

Where to begin

  1. Getting started: install FlowMotion and check that it works.
  2. Your first diagram: create and play a diagram in a note.
  3. Writing diagrams: learn the text format that FlowMotion reads.

Authoring reference for people and AI tools

Start with the FlowMotion authoring reference for YAML keywords, defaults, limits, and execution rules. Use the authoring cookbook for complete examples and validation commands. To generate or edit a diagram with an AI assistant, copy the AI authoring skill and the schemas for your FlowMotion version.

The reference labels development features explicitly. Match the documentation and schemas to your installed plugin build.

Current status

FlowMotion is at version 1.0.0. Automated tests cover the drawing engine and selected Obsidian desktop workflows, including loading, SVG rendering, settings, and saved preferences. The desktop suite runs against Obsidian 1.4.5, 1.15.1, and latest. It does not cover every editor workflow. Test FlowMotion in a copy of your vault before relying on it for important notes. See Known limitations and Testing and examples.

Clone this wiki locally