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.
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:

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-costprices 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
jlcapplies 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.