soldermask
soldermask turns a sentence into a board you can order. It designs the circuit, finds parts in stock, places and routes the board, and writes the fab files.

Start here
Install
Install soldermask and check your setup.
Your first board
Go from one sentence to Gerbers, and learn what to check on the way.
The app
Projects, the workbench, versions and exports.
Command line
Build a board from the terminal. Every command and flag.
MCP server
Drive the pipeline from Claude or another agent.
The pipeline
Each stage: what it decides, and what it cannot promise.
What one build gives you
| Stage | You get |
|---|---|
| Design | A netlist of parts and nets, with the model's assumptions and what it could not do |
| Parts | Every part matched to a real LCSC part in stock, with its price |
| Checks | An electrical rule check, and pin names checked against KiCad's symbols |
| Simulation | The circuit as wired, switched on in ngspice, with each traced net's voltage over time |
| Layout | The parts placed and routed on two or four copper layers, with a ground pour |
| Verdict | KiCad's DRC of the finished copper, and one word for the board: GO, NO-GO or UNJUDGED |
| Fab files | Gerbers and drill files, a BOM and CPL for JLCPCB, a KiCad project and 3D models |
| Price | Cost and stock at 1, 10, 25 and 100 boards |
| History | Every build saved as a version you can compare, restore or fork |
Read the gaps before you order
Every stage reports what it could not do, next to the board. That list is the gaps. Each board also gets a verdict: GO, NO-GO or UNJUDGED, when a check it needs did not run. Read What is not guaranteed before you send a board to a fab.
More
Reference
Every command, endpoint, file and setting.
Operations
Run, secure and deploy your own server.
Research
The models behind placement, and what they measured.
Development
Code layout, tests, releases, and how to write these docs.
Two kinds of version
The app has a version number, which soldermask version prints. Each project also keeps every board it built as a numbered version. Versioning and releases explains both.