Documentation · Quickstart

From prompt to PCB
in five minutes.

Open the editor, sign in for AI credits, and describe the board. Claude designs while the verification gate checks.

Open Cherry Blossom →
  1. 1

    Open Cherry Blossom

    app.trycherryblossom.com opens the editor with no install. You start on an empty 50 × 50 mm board called Untitled Circuit.

  2. 2

    Sign in for AI credits

    Open Settings with the gear icon or Ctrl/⌘ ,, then select Cherry Blossom account and sign in. AI credits come with your plan, so there are no third-party credentials to provide. Your first Pro subscription includes a 14-day trial.

  3. 3

    Describe your board

    Open the AI Assistant with the chat button or Ctrl/⌘ L and describe what you want to build. Try “Design a 555 timer LED blinker” or “Add an ESP32 with USB-C power”. Claude edits the circuit live while it finds parts, footprints, and datasheets.

  4. 4

    Let the verification gate check it

    After every AI edit, the gate reports either Circuit validated: no errors or a concrete issue such as an unconnected pin or missing footprint. It does not auto-fix; ask Claude to address each flag.

  5. 5

    Inspect every view

    Switch between Schematic, PCB, 3D, and BOM tabs. The PCB view includes select, move, route, autoroute, and a DRC inspector. Want the raw source? Settings → Advanced → Show Code tab reveals the circuit's TSX.

  6. 6

    Export for fabrication

    Select Export for a KiCad project, Circuit JSON, BOM CSV, tscircuit TSX, or a reusable Project JSON file. Work autosaves in the browser, and Ctrl/⌘ S downloads a project file anytime.

Good to know

Before you go deep.

Costs & limits

Pro includes access to frontier models, 2M AI credits each month, and 200 AI actions per day. The chat explains when you reach a limit and when credits reset.

Your data

Projects autosave in your browser or live in files you download. Your designs are not stored in a Cherry Blossom cloud workspace.

Rough edges

This is an early beta with weekly releases. Save before starting a new circuit, and tell us in Discord if something breaks.

Stuck or found a bug? Ask in the Discord, which both founders read, or email us directly.