Python · Command-line tool · Apache-2.0

kicad-fab-tools

Turns a KiCad board into a fab and assembly order and checks it first: design rules, parts list against the board, live parts stock and price.

View on GitHub

FirePod runs on a circuit board we design ourselves, and a wrong line in an order can cost weeks. These are the checks we run before anything goes to the factory: a design-rule summary, every footprint matched to the parts list, stock for the number of boards we want, and rotation fixes that remember when the factory’s “upright” differs from KiCad’s. The release post explains why we built it.

A design-rule summary you can read

KiCad’s design-rule check can return hundreds of lines. kicad-fab drc counts them by type and severity first, then lists the errors and any open connections, and exits with an error code so a script can stop on it. Here it is on Antmicro’s open DDR4 tester, opened in KiCad 10:

kicad-fab drc on Antmicro's DDR4 tester: counts of errors and warnings by type, then the three errors listed with the parts and layers involved

The checks

  • Parts list against the board. Every footprint has exactly one line in the parts list, every placed part in the list is on the board, and the footprint names agree.
  • Live stock. Each part from LCSC is checked for the number of boards you’re ordering, plus spares.
  • Cost. bom-cost prices the placed parts at your quantity and counts the extended parts that add a setup fee.
  • Rotation and offset fixes. A small CSV records parts the factory places differently from KiCad, and jlc applies it every time it writes the placement file.

One command for the order

kicad-fab fab runs the design-rule check, stops if there are errors, then zips Gerbers for every copper layer with the drill files, checks the parts list against the board and writes JLCPCB’s parts and placement files. It needs Python 3.9 or newer and KiCad 8 or newer, and nothing else.

Get started

pip install git+https://github.com/firedanceio/kicad-fab-tools
kicad-fab fab board.kicad_pcb --bom bom.csv -o fab-out
kicad-fab bom-check --board board.kicad_pcb --bom bom.csv --qty 10
kicad-fab bom-cost --bom bom.csv --boards 10

Full instructions are in the README on GitHub.

Read the announcement: kicad-fab-tools: circuit board orders, checked.

Get updatesGet the early-bird price

Firedance isn't available yet. Leave your email and we'll let you know when it launches.

Leave your email and you'll hear first when Firedance launches, so you can get the early-bird price.