Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Vertepnyk

Volodymyr PavlyshynVolodymyr Pavlyshyn22 downloads

Design and simulate vertep statecharts: SCXML and YAML chart files, chart code blocks and embeds.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates1

Vertepnyk: the puppeteer in the vertep under the Christmas star

Vertepnyk

A visual designer and simulator for vertep statecharts: draw a chart, edit it, validate it and drive it with events, without writing code.

The name is the vertepnyk (вертепник), the puppeteer who builds the vertep box and runs the show. Vertep charts are the stage whose slots the puppets move along; vertepnyk is where you cut the slots and try the play.

Website: volland.github.io/vertep/vertepnyk.html · Article: Two hands on one chart: co-designing with Claude Code

What it does

  • Draw and edit SCXML (*.scxml) and vertep YAML (*.vt.yaml) charts: atomic, compound, parallel, final and history states, transitions, the datamodel and executable content.
  • Keep your file yours: the text is the source of truth and visual edits are minimal patches, so comments and formatting survive and git diffs stay small. Layout lives inline in vertep's reserved layout namespace and never changes the chart's content hash.
  • Validate and simulate on vertep itself: the designer runs vertep's WebAssembly interpreter, so what you see is exactly what production runs. Send events with payloads, watch the active configuration and context, and travel back and forth through the run.
  • Run where your charts live: a VS Code extension, an Obsidian plugin (including charts in code blocks), and a standalone Electron app.

Install

Version 0.1.0 is a preview.

  • VS Code: install Vertepnyk from the VS Code Marketplace (code --install-extension pavlyshyn.vertepnyk-vscode). For Cursor, VSCodium and other VS Code builds it is on Open VSX. Open a chart with Open With… > Vertepnyk Designer.
  • Obsidian (desktop): the listing in Obsidian's community directory is pending. Until then, download main.js, manifest.json and styles.css from the 0.1.0 release into <vault>/.obsidian/plugins/vertepnyk/ (or unpack vertepnyk-obsidian-0.1.0.zip into .obsidian/plugins/), then enable it under Community plugins. The plugin is self-contained: those three files are all it needs.
  • macOS app: Vertepnyk-0.1.0-universal.dmg from the release (not notarized yet: open it the first time with right-click > Open). Windows and Linux: build from source.

Build from source

pnpm install
pnpm build
pnpm dev                                       # web shell
pnpm --filter vertepnyk-vscode run package     # VS Code extension (.vsix)
pnpm --filter vertepnyk-electron run dist      # desktop app for this OS

Until @vertep/web and @vertep/dm-ecma are on npm, pnpm-workspace.yaml links them from a sibling vertep checkout (../vertep, 0.1.4 or later); build them first with npm run build in its bindings/js.

Status

M1 to M5 are implemented: all 71 requirements are implemented and verified. Known limitations:

  • Vertep 0.1.3 on crates.io does not yet treat the vl: layout namespace as formatting, so its vt hash changes when layout changes; the engine bundled here already ignores layout, and the next vertep release will too.

  • Automatic layout is written into the file when it first opens, so a fresh chart shows as modified, and in VS Code that undo takes two presses.

  • .vt.yaml cannot be bound by extension in Obsidian or Electron. The Obsidian plugin is checked in real Obsidian 1.14 with pnpm --filter vertepnyk-obsidian run test:real.

  • Specs: openspec/changes/designer-core and openspec/changes/editor-hosts

  • Design intent as a typed graph: tg.md/ (tg check, tg cypher)

  • Roadmap: tg.md/roadmap.md

Stack: TypeScript, SolidJS, SVG, elkjs, pnpm workspaces, Vite, Vitest, Playwright, @vertep/web.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option (see LICENSE).

HealthExcellent
ReviewCaution
About
Design and simulate vertep statecharts (SCXML and vertep YAML) visually without writing code. Edit charts while preserving the source text and comments; run the built-in WebAssembly interpreter to validate, send events with payloads, inspect active configuration and context, and replay runs.
DrawingVisualization
Details
Current version
0.1.0
Last updated
5 days ago
Created
5 days ago
Updates
1 release
Downloads
22
Compatible with
Obsidian 1.5.0+
Platforms
Desktop only
License
OTHER
Report bugRequest featureReport plugin
Sponsor
PayPal
Author
Volodymyr PavlyshynVolodymyr Pavlyshynpavlyshyn
www.pavlyshyn.me
GitHubvolland
pavlyshyn
volodymyrpavlyshyn.substack.com
VolodymyrPavlyshyn
medium.com
  1. Community
  2. Plugins
  3. Drawing
  4. Vertepnyk

Related plugins

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Mermaid Tools

Improved Mermaid.js experience: visual toolbar with common elements and more.

tldraw

Integration with tldraw, allowing users to draw and edit content on a virtual whiteboard.

Kroki

Render Kroki diagrams.

Simple mind map

A mind map that combines aesthetics and functionality. 一个颜值与功能并存的思维导图。

Mermaid Flow

Create and edit Mermaid flowcharts visually by dragging nodes and drawing connections. No Mermaid syntax required.

Advanced Canvas

Supercharge your canvas experience. Create presentations, flowcharts and more.

ExcaliBrain

An interactive, structured mind-map of your Obsidian vault.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.

Maps

Adds a map layout to bases so you can display notes as an interactive map view.