Skip to content

Quick Start

Go to chinilla.com/workspace in your browser.

The launcher gives you three ways to start:

  1. Guided Wizard — answer a few questions (what you’re building, the main flow, scale, what could go wrong) and the AI hands you a first draft.
  2. Template — start from a ready-made system. Three groups:
    • Lessons (free) — small designs that each teach one idea (Pipeline Basics, Branching & Merging, Resilience Patterns, Batch & Scale, Full Loop, Circuit Breaker Test).
    • Examples (free) — real-world workflows (AI Evaluation Pipeline, Pottery Business).
    • Interview (Pro) — classic system design interview problems (URL Shortener, Chat App, Notifications, Rate Limiter, File Upload, Pub/Sub, CDN, News Feed).
  3. Blank Canvas — drop blocks yourself.

New here? Start with a Lesson. Every block in a lesson has a description that explains what it does and what to watch for once you hit play.

  1. Press A or click Add to switch to the Add tool.
  2. Click on the canvas (or drag the + button) to drop a block. The setup window opens. Set the first one up as a Client, drop another, set it up as an API.
  3. Press C or click Connect, then click the Client and then the API to draw a line between them.
  4. Double-click a block any time to rename it, change its description, or tweak numbers.

Click Play in the timeline bar at the bottom. Items start flowing along your lines. Lines that get clogged turn yellow or red — that’s a bottleneck. The top bar shows live numbers (health, delivery rate, item counts) while it runs. Open the Overview panel from the left toolbar for a deeper read, plus Stability (Pro) and Monte Carlo (Pro).

Open the Stress Test panel inside Overview to push your design harder:

  • One-click scenarios — Baseline, Peak Traffic, Outage, Slowdown, Flash Spike, Cascade.
  • Traffic dials — set how many items to send (1-1000) in the timeline bar and a traffic multiplier (1-10x) in the stress panel.
  • Break things on purpose — kill a block or slow a line to see what happens.

Open AI chat (the Chinilla AI button in the top-right) and ask for improvements, or fix things by hand. Run again to see if you actually fixed it.