soldermaskdocs

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

KeyWhat it holds
name, width, heightThe 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.
symbolsSchematic drawings, one per distinct symbol, in KiCad mils with y up. A part with no library drawing gets a box under generic:<ref>.
sheetThe 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.
planesA four-layer board's plane layers as [{layer, net}]. Absent on two layers.
insigniaThe maker's mark as filled polygons, exactly as the silkscreen inks it. null when the board has no room for it.
routingThe router's account. See Routing.
verdictWhether the board passes. See The verdict.
rejudgedPresent on a board soldermask projects rejudge rewrote: when, the judge, its copper counts, its own markers, and was, the verdict before
pollThe 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.
ercEvery 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
physicsEach 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_rulesThe 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.
stackupThe layer build: the fab's standard stackup, not a choice this pipeline made
fabMeasurements a fab holds the board to: track widths, vias, drills, clearance, pads. npth_drills counts the non-plated holes by size.
fab_rulesJLCPCB'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.
rubricThe design rubric's grades: catalogue, graded, measures, reference and verdicts. It does not change passed.
bomParts cost at quantity 1, and the setup fee for extended parts
inventoryThe stock check at 1, 10, 25 and 100 boards. See Stock and pricing.
precedentsCorpus boards this design was matched against, best first. The one that seeded the placement is marked seeded.
generationWhere 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.

KeyWhat it holds
ref, kind, value, purpose, packageAs in the design
lcsc, mfr, price, basic, stockThe ordered part: its code, maker's number, unit price, basic or extended, and stock
symbol, symThe symbol name, and its key into symbols
x, y, rot, w, hWhere the part sits, its turn and its size
sidefront or back. A back part is drawn mirrored, on the back copper.
body_w, body_h, body_z, lead, standoffThe 3D profile
body_x, body_yThe body's offset from the part's origin
pads[]Each pad's name, position, size, shape, th (through-hole) and drill
pads[].shapeWhat the fab flashes: rect, circle or roundrect. A circle longer than it is wide is an oval.
pads[].radiusA roundrect pad's corner radius. Present only on such a pad.
pads[].polyA custom pad's corners, in board mm. Present only on a pad drawn as a polygon.
pads[].slotA 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.
bodyThe body's four corners (F.Fab), turned and mirrored with the part
courtThe 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

KeyWhat it holds
name, kindThe 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_vNominal volts against ground, or null. The ERC needs it for Ohm's law.
current_aSteady amps, or null. The copper is sized from it.
width_mmThe 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.

KeyWhat it holds
passedtrue, false, or null when a check it needs did not run
whyEach failed clause, as a sentence
erc_ran, copper_judgedWhether the ERC ran, and whether KiCad's DRC judged the copper
parts_asked, parts_resolvedThe parts the design named, and the parts that resolved
dropped_nets, dropped_connectionsNets and pins the design asked for that are not on the board
erc_errors, unrouted, pour_errorsERC errors, nets left open, and copper errors DRC found
hot_copperNets whose copper reaches a 100 °C rise at their declared current. One fails the board.
routing_requiredfalse when the build was not asked to route
layout_rulesThe datasheet layout rule counts, when a rule was checked

Routing

routing is null on a board built before it was recorded.

KeyWhat it holds
predictedThe 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
chosenThe index of the kept attempt
routerThe kept attempt's counts
tandemWhen Lightcycle ranked the placements: each one it routed, the order by seed, and any extra placements (more)
seedThe anneal seed the board was placed with
placement_giventrue when every part's position was handed in, so nothing was annealed
track_mm, clearance_mmThe track width and clearance the board was routed at. rule holds the same with the router's name.
thermalEach 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.
heatThe routability model's map of the kept placement: expected copper and unreached pins per cell. It is a prediction, not the heat check.
reliabilityThe model's held-out table: in each band of its score, how often a board routed clean
pour_pcbWhere the poured board was written during the build
pourWhat the pour did. pour.markers is where its DRC found each error and starved thermal.
drcKiCad's check of the copper as shipped, with markers in the same shape
incompleteNet name → the pins its copper never reaches

Markers

A marker is one DRC finding, in the board's frame (y up, millimetres).

KeyWhat it holds
kindDRC's name for it, such as hole_clearance, or pour_split
severror when it counts against the copper, advisory for a starved thermal
messageKiCad's own sentence, with the rule and the measured value
atWhere to draw it: the middle of the items that are not a zone
items[]Each item DRC named: what and at
refsThe 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.

KeyWhat it holds
symbolsPart → x, y, rot, mir, units, role, pinned, box
wiresPolylines. stub marks a pin's label stub; trunk marks a lane.
junctionsJunction dots
labelsNet labels: net, x, y, rot
portsPower ports: net, kind, x, y, dir
ncNo-connect marks
textsWhere each part's reference and value are written
frameThe sheet size, and where the drawing sits on it
undrawnPads with no pin in their drawing
statsCounts 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 silk or pad shape. 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.

On this page