bread. DOCS

BREAD / GUIDES

Connections in. Wiring out.

Bread turns a small connection-only language into a checked breadboard wiring diagram. Start with an example, then learn the supported rules.

Describe → verify → wire

Describe parts and nets, not hole positions. Bread assigns supported components to a fixed breadboard, adds jumper wires, then independently reconstructs physical connectivity and compares it with the logical nets.

The Playground runs the same compiler and renderer in a browser worker. Source stays in the tab; reloading discards edits. Only the language preference is saved locally. No account or circuit upload is required.

A complete first diagram

blink.breadOne Uno, one 220Ω resistor and one LED in series.
bread 0.1

title "Arduino LED"

part uno: arduino-uno-r3
part r1: resistor [value=220ohm]
part led: led-5mm-red

uno.D13 -- r1.1
r1.2 -- led.A
led.K -- uno.GND
One Uno, one 220Ω resistor and one LED in series.

Illustration adapted from Arduino UNO R3 CAD by Bread contributors; CC-BY-SA-4.0. Source and modifications are embedded in the SVG. Attribution

Understand what is verified

A matching netlist establishes modeled connectivity. It does not establish voltage/current limits, component fit, safe assembly, firmware behavior or simulation. Use the Limits guide before building hardware.

This documentation describes the checked-out build, including the two discrete-part samples. A separately deployed Playground can be an older version. Follow its available sample buttons and support information.