board.json
A board file holds everything the three views draw, already worked out, so the viewer never repeats the placement maths.
Every version has one. export.board_json() writes most of it, and the build
adds the sheet, the checks and the verdict. The app serves it at
/api/projects/<slug>/versions/<vid>/board.
{
"name": "ne555-led-blinker", "width": 28, "height": 22,
"components": [ { "ref": "U1", "kind": "ic", "value": "NE555", "purpose": "timer",
"package": "SOIC-8", "lcsc": "C7593", "mfr": "NE555DR",
"price": 0.1263, "basic": true, "stock": 209000,
"symbol": "NE555D", "sym": "Timer:NE555D",
"x": 15.35, "y": 7.17, "rot": 90, "w": 6.4, "h": 5.2,
"body_w": 4.9, "body_h": 3.9, "body_z": 1.75, "lead": "gullwing", "standoff": 0.15,
"pads": [ { "name": "1", "x": 12.6, "y": 5.3, "w": 0.6, "h": 1.5, "shape": "rect", "th": false, "drill": 0 } ],
"silk": [ { "pts": [[12.15, 4.1], [12.15, 10.2]], "w": 0.15 } ],
"body": [[12.5, 4.7], [18.2, 4.7], [18.2, 9.6], [12.5, 9.6]],
"court": [12.15, 18.55, 4.1, 10.2] } ],
"symbols": { "Timer:NE555D": { "rects": [], "polys": [], "arcs": [], "texts": [], "pins": [], "fields": {} } },
"nets": [ { "name": "GND", "kind": "ground", "voltage_v": 0, "current_a": null, "width_mm": 0.25,
"pins": [ { "ref": "U1", "pad": "1", "fn": "GND" } ] } ],
"wires": [ { "net": "OUT", "layer": "F.Cu", "width": 0.25, "pts": [[15.3, 7.2], [18.0, 7.2]] } ],
"vias": [ { "net": "GND", "x": 10.1, "y": 4.4, "d": 0.6, "drill": 0.3 } ],
"insignia": { "fills": [ [[10.4, 1.0], [11.9, 1.0], [11.9, 2.5], [10.4, 2.5]] ] },
"erc": [ { "severity": "warning", "rule": "floating-pin", "message": "U1 pin(s) ['5'] unconnected" } ],
"gaps": [], "notes": [],
"bom": { "parts": 0.36, "setup": 9.0 },
"inventory": { "quantities": [1, 10, 25, 100], "reports": { "1": { "qty": 1, "buildable": true, "parts_cost": 0.36, "setup_cost": 9.0, "total": 9.36, "per_board": 9.36, "checked_live": true, "lines": [ { "lcsc": "C7593", "refs": ["U1"], "needed": 2, "stock": 209000, "headroom": 104500.0, "risk": "ok", "note": "" } ] } } },
"generation": { "prompt": "A 555 timer LED blinker running from 5V", "backend": "claude-code", "model": "claude-fable-5-2",
"summary": "…", "assumptions": [], "unsupported": [], "decisions": [],
"input_tokens": 4210, "output_tokens": 1180, "cost_usd": null,
"list_usd": 0.41, "billing": "claude.ai plan" }
}All board positions are in mm, with the origin at the bottom left and y up.
Keys
| Key | What it holds |
|---|---|
name, width, height | The board's name and size |
components[] | The resolved parts. See Components. |
holes[] | Non-plated holes that belong to no part: the mounting holes a design asks for, or one on a board read from a file. Present only when there are some. |
symbols | Schematic drawings, one per distinct symbol, in KiCad mils with y up. A part with no library drawing gets a box under generic:<ref>. |
sheet | The laid-out schematic. See The sheet. |
nets[] | Each net's name, kind, pins and electrical facts. See Nets. |
wires[] | Routed copper as the router returned it: net, layer, width, pts. The layer is any copper layer of the stack, such as In2.Cu on four layers. |
paths[] | The same copper chained into tracks, with rounded corners where the build rounded them. The views draw these when present. |
vias[] | Each via's net, position, pad diameter d and drill |
zones[] | Poured copper as KiCad filled it: net, layer, pts. An inner plane's fill is here too. Empty on a board with no pour. |
planes | A four-layer board's plane layers as [{layer, net}]. Absent on two layers. |
insignia | The maker's mark as filled polygons, exactly as the silkscreen inks it. null when the board has no room for it. |
routing | The router's account. See Routing. |
verdict | Whether the board passes. See The verdict. |
rejudged | Present on a board soldermask projects rejudge rewrote: when, the judge, its copper counts, its own markers, and was, the verdict before |
poll | The verdict as the app draws it. word is GO, NO-GO or UNJUDGED, from passed. stations has one row each for parts, nets, ERC, route and copper: go, hold, unjudged or skip. holding, unjudged and advisories are counts. It is computed again whenever the board is read. |
erc | Every electrical finding: severity, rule, message. null means no check ran, for example on a board read from a KiCad file. |
gaps[], notes[] | What could not be done, and what was done and is worth knowing |
physics | Each part's job read off its wiring, and its current loops measured, such as a decoupling capacitor's loop in nH. said counts the checks worse than three in four of people's boards. null on a board with no parts. |
layout_rules | The datasheet layout rules checked on the board. Each row is ok, violated or not checkable, with the measured value, the limit, where the limit came from, and the quote and page. null when no part has a rule. verdict.layout_rules holds the counts. Neither changes passed. |
stackup | The layer build: the fab's standard stackup, not a choice this pipeline made |
fab | Measurements a fab holds the board to: track widths, vias, drills, clearance, pads. npth_drills counts the non-plated holes by size. |
fab_rules | JLCPCB's published table checked on the board: fab, read, pages, service, findings, counts and unchecked. Its findings land in the gaps and notes. It does not change passed. |
rubric | The design rubric's grades: catalogue, graded, measures, reference and verdicts. It does not change passed. |
bom | Parts cost at quantity 1, and the setup fee for extended parts |
inventory | The stock check at 1, 10, 25 and 100 boards. See Stock and pricing. |
precedents | Corpus boards this design was matched against, best first. The one that seeded the placement is marked seeded. |
generation | Where the design came from: the prompt, backend, model, tokens, cost, and the model's summary, assumptions, decisions and unsupported |
Components
Pad positions are absolute and already rotated.
| Key | What it holds |
|---|---|
ref, kind, value, purpose, package | As in the design |
lcsc, mfr, price, basic, stock | The ordered part: its code, maker's number, unit price, basic or extended, and stock |
symbol, sym | The symbol name, and its key into symbols |
x, y, rot, w, h | Where the part sits, its turn and its size |
side | front or back. A back part is drawn mirrored, on the back copper. |
body_w, body_h, body_z, lead, standoff | The 3D profile |
body_x, body_y | The body's offset from the part's origin |
pads[] | Each pad's name, position, size, shape, th (through-hole) and drill |
pads[].shape | What the fab flashes: rect, circle or roundrect. A circle longer than it is wide is an oval. |
pads[].radius | A roundrect pad's corner radius. Present only on such a pad. |
pads[].poly | A custom pad's corners, in board mm. Present only on a pad drawn as a polygon. |
pads[].slot | A plated slot's length along the pad's longer side, where the hole is a slot drill wide. Present only on such a pad. |
holes[] | The part's non-plated holes as [x, y, drill], such as a connector's locating pegs. A slot is [x, y, width, length, angle]. Present only when it has some. |
cutouts[] | Where the part needs the board milled away, as closed polygons. Present only when it has some. |
silk[] | The part's silkscreen strokes: pts and pen width w, or fill: true for a solid shape. The Gerber and the .kicad_pcb carry the same strokes. |
body | The body's four corners (F.Fab), turned and mirrored with the part |
court | The courtyard box [x0, x1, y0, y1] the placer kept clear (F.CrtYd) |
The silkscreen is the vendor's own drawing where the footprint is the vendor's. Otherwise it is drawn clear of the pads, from the body and pins.
Nets
| Key | What it holds |
|---|---|
name, kind | The net and its kind: ground, power or signal |
pins[] | Each pin as ref, pad and fn, the function name the pad was resolved from |
voltage_v | Nominal volts against ground, or null. The ERC needs it for Ohm's law. |
current_a | Steady amps, or null. The copper is sized from it. |
width_mm | The width the net is designed for |
width_mm is the largest of three: the board's signal track, the min_track_mm
floor, and what IPC-2221 asks for the net's current. On a board built from a
design, the signal track is 0.127 mm with Lightcycle or A*.
The verdict
verdict says whether the board passes. The poll is drawn from its counts.
| Key | What it holds |
|---|---|
passed | true, false, or null when a check it needs did not run |
why | Each failed clause, as a sentence |
erc_ran, copper_judged | Whether the ERC ran, and whether KiCad's DRC judged the copper |
parts_asked, parts_resolved | The parts the design named, and the parts that resolved |
dropped_nets, dropped_connections | Nets and pins the design asked for that are not on the board |
erc_errors, unrouted, pour_errors | ERC errors, nets left open, and copper errors DRC found |
hot_copper | Nets whose copper reaches a 100 °C rise at their declared current. One fails the board. |
routing_required | false when the build was not asked to route |
layout_rules | The datasheet layout rule counts, when a rule was checked |
Routing
routing is null on a board built before it was recorded.
| Key | What it holds |
|---|---|
predicted | The model's rating of the first placement, and which model rated it |
candidates[] | Every placement annealed: its seed, wirelength cost and p_clean |
attempts[] | Each placement routed: unrouted and violation counts, incomplete nets, seconds, clean |
chosen | The index of the kept attempt |
router | The kept attempt's counts |
tandem | When Lightcycle ranked the placements: each one it routed, the order by seed, and any extra placements (more) |
seed | The anneal seed the board was placed with |
placement_given | true when every part's position was handed in, so nothing was annealed |
track_mm, clearance_mm | The track width and clearance the board was routed at. rule holds the same with the router's name. |
thermal | Each net whose copper runs narrower than its declared current asks, away from its pads: the worst run's width, length and rise_c. The verdict reads it. |
heat | The routability model's map of the kept placement: expected copper and unreached pins per cell. It is a prediction, not the heat check. |
reliability | The model's held-out table: in each band of its score, how often a board routed clean |
pour_pcb | Where the poured board was written during the build |
pour | What the pour did. pour.markers is where its DRC found each error and starved thermal. |
drc | KiCad's check of the copper as shipped, with markers in the same shape |
incomplete | Net name → the pins its copper never reaches |
Markers
A marker is one DRC finding, in the board's frame (y up, millimetres).
| Key | What it holds |
|---|---|
kind | DRC's name for it, such as hole_clearance, or pour_split |
sev | error when it counts against the copper, advisory for a starved thermal |
message | KiCad's own sentence, with the rule and the measured value |
at | Where to draw it: the middle of the items that are not a zone |
items[] | Each item DRC named: what and at |
refs | The parts those items belong to |
A board keeps at most 60. A rejudge keeps its own in rejudged.markers.
Boards built before 8 Oct 2026 have none. GET /api/projects/<slug>/versions/<vid>/markers
returns them for any version, asking KiCad's DRC again where none were kept.
The sheet
sheet is the schematic laid out by sheet.py, in mils with y down. It is
rebuilt on read for boards saved before it existed.
| Key | What it holds |
|---|---|
symbols | Part → x, y, rot, mir, units, role, pinned, box |
wires | Polylines. stub marks a pin's label stub; trunk marks a lane. |
junctions | Junction dots |
labels | Net labels: net, x, y, rot |
ports | Power ports: net, kind, x, y, dir |
nc | No-connect marks |
texts | Where each part's reference and value are written |
frame | The sheet size, and where the drawing sits on it |
undrawn | Pads with no pin in their drawing |
stats | Counts about the layout |
Older boards
A board saved before a key existed is still readable:
- The symbol table, the stackup and the fab sheet are rebuilt on read (
export.attach_symbols,export.attach_fab). - Boards built before 15 Sep 2026 have no
silkor padshape. The views draw a courtyard box and rounded pads instead. - Without
routing, the workbench judges a net routed if it has any wire at all.