Export Formats

Chinilla supports multiple export formats accessible from the header export button.

Backup JSON

Full canvas state saved as a .chinilla.json file. Includes:

• All components with positions, metrics, requirements, behaviors, and costs
• All connections with waypoints, directions, and labels
• All drawings, notes, tickets, and groups
• Validation scores (if available)
• Simulation results (if available)

Use this for backup and restore. Import via the header import button.

System Spec

A deterministic architecture document generated from your canvas (no AI required):

• Topology - Component count, connection count, density metrics
• Components by type - Grouped listing with descriptions, metrics, protocol, scaling details, and full behavior configuration (mode, expression, failure rate, drop rate, capacity, delay, etc.)
• Data flow - Entry points, exit points, critical paths
• Connections table - Source, target, label, direction, latency, and routing weight
• Quality scores - Six Instincts scores (if validated)
• Simulation results - Timeline and failure analysis (if simulated)

Copy to clipboard or download as markdown.

AI Spec (PRD)

A comprehensive Product Requirements Document generated by xAI:

1. Overview and objectives
2. Architecture summary
3. Component specifications
4. Data flow analysis
5. Failure modes and mitigations
6. Non-functional requirements
7. Implementation notes
8. Open questions

Requires a valid xAI API key. Copy to clipboard or download.

Image Export (PNG)

Open the Export modal and select the Image tab (default). You get:

• Live preview of the canvas render
• Dark/Light toggle to switch the export theme
• Grid checkbox to include or hide the background grid
• Labels checkbox to show or hide connection labels
• Copy to clipboard using the browser ClipboardItem API
• Download PNG at high resolution (adaptive scaling, up to 8192px per side)

Icons, cubic Bezier connections, behavior colors, groups, notes, and tickets all render at full fidelity.

Copy as Markdown

Click Markdown in the Image tab footer to copy a ready-to-paste Markdown image embed:

• If your design is published, the embed links to your share URL: [![Project](url/og.png)](url)
• If not published, the PNG is encoded inline as a base64 data URL: ![Project](data:image/png;base64,...)

Paste directly into GitHub READMEs, Notion pages, blog posts, or any Markdown renderer.

SVG Export

The SVG tab generates a true scalable vector graphic of your canvas:

• Components rendered as SVG text elements with behavior-colored icons
• Connections rendered as cubic Bezier <path> elements with proper arrowheads
• Groups as rounded <rect> elements with labels
• Freehand drawings preserved as SVG paths
• Connection labels in rounded pill backgrounds
• Dark/Light toggle, Grid, Labels, and Descriptions checkboxes (same as Image tab)
• Copy SVG to clipboard for pasting into design tools or HTML
• Download SVG as a .svg file
• Markdown button copies the same embed format as the Image tab

SVGs scale perfectly at any size, have tiny file sizes, and render crisply in docs, presentations, and print.

Animated GIF Export

The GIF tab in the Export modal generates an animated GIF of your simulation playback:

• Runs the full flow execution (topological steps with packet routing)
• Each frame shows active components (cyan highlight), active connections (dashed cyan), traversed connections (faded cyan), and queue depth dots
• HUD overlay renders on every frame: health % with color-coded indicator, cumulative In/Out/Lost/Queue stats, a delivery rate bar, formatted time, step counter, and bottleneck callout (if one exists)
• Status pills render in each frame: green “delivered” on exit nodes, blue “entered” on entry nodes, amber “processing” on soak/delay components with queued items, and accent “done”/“waiting”/“lost” on active components
• Speed selector: 1x, 2x (default), or 4x
• Dark/Light toggle for the GIF theme
• Loops infinitely by default
• Download the generated GIF for use in READMEs, docs, or presentations

The GIF encoder is built-in (no external dependencies). Frame delay is 2400ms / speed, so at 2x each step holds for 1.2 seconds.

Python Export

A deterministic Python scaffold generated from your canvas (no AI required). Produces a runnable .py file with:

• Protocol-aware imports - Appropriate client libraries based on each component’s protocol setting (httpx for HTTP/GraphQL, grpc for gRPC, websockets, pika for AMQP, kafka-python for Kafka, paho-mqtt for MQTT)
• Component classes - One class per component with behavior-accurate logic:
  • Transform: Converts transformExpr to Python dict-access syntax (e.g. data['total'] = data['price'] * data['qty'])
  • Retry: Injects simulated failures using the configured failureRate with exponential backoff
  • Circuit Breaker: Simulates failures at the configured failureRate with threshold-based state transitions
  • Split: Supports both round-robin and weighted probabilistic routing based on connection weights
  • Condition: Converts JavaScript expressions to Python-safe dict access
• ThreadPoolExecutor - Components with maxInstances > 1 get a thread pool sized to their max instance count
• Pipeline function - Wires components together following the canvas connection topology, including weighted targets for split nodes

The export reads directly from your canvas state. No API key required.

Mermaid Diagram

A Mermaid flowchart generated from your canvas topology:

• Components mapped to Mermaid shapes by type (cylinder for storage, diamond for decision, etc.)
• Metrics included in node labels (throughput, capacity, processing time)
• Connection directions preserved (forward, backward, bidirectional, none)
• Connection labels and routing weights included on edges (e.g. w:70)
• Groups rendered as Mermaid subgraphs
• Line styles mapped (solid, dashed, dotted)

Copy to clipboard or download as .mmd for use in GitHub, Notion, or any Mermaid-compatible renderer.

Integrations

Integration	Description
GitHub Gist	Publish your System Spec as a Gist
Slack	Send a design summary to a Slack channel via webhook
Notion	Export to a Notion page
Jira	Create a Jira issue from your design

Publish (Interactive Preview)

Turn any design into a public, read-only preview that anyone can explore without an account.

How to publish

1. Open the File menu in the workspace toolbar
2. Click Publish
3. Toggle the Published switch on
4. Copy the generated link

The link looks like chinilla.com/share/abc123xyz. Anyone with the link can:

• Pan and zoom the full canvas
• Inspect every component and connection
• Toggle the simulation timeline on/off
• Toggle KPI overlays on/off
• Switch between dark and light mode
• Copy the design into their own workspace with “Open in Chinilla”

Publish from the dashboard

Click the publish icon on any project card in your dashboard. The modal shows the same toggle and link.

Views and likes

Every published design tracks:

• Views - incremented each time someone opens the preview
• Likes - logged-in users can like a design (one like per user)

Both counts are visible on the preview page and on your dashboard project cards.

Unpublishing

Toggle the Published switch off in the same modal. The link stops working immediately. View and like counts are preserved if you republish later.