drawtonomy.svg format
A drawtonomy.svg file is a regular SVG augmented with metadata
that records the editor-only state.
Structure
Section titled “Structure”- The visual content (paths, text, images) is plain SVG. Any SVG viewer renders it correctly.
- A
<metadata>block at the top of the document holds the drawtonomy-specific data:- shape IDs and per-shape props (template, style, etc.)
- lane connection slots (
next,previous,left,right) - shared-point references
- footprint group membership
- z-order
Compatibility
Section titled “Compatibility”Editing a drawtonomy.svg in a generic SVG editor (Illustrator,
Inkscape, the browser) drops the metadata block on save unless you
preserve it explicitly. drawtonomy can still open the result, but
connections and shared points will be missing.
For round-trippable edits outside drawtonomy, use the SDK
(@drawtonomy/sdk) — it can read and write the
format without going through the editor.
Versioning
Section titled “Versioning”Older files are migrated automatically on import. The
resolveColorKey() helper in the SDK converts legacy color keys
(for example, v1.x grey-700) to the current ones.