soldermaskdocs

soldermask

A prompt to a fab-ready two-layer board. You describe a board in a sentence; soldermask has a model design it, resolves every part against live JLCPCB stock, checks the netlist, places and routes the board, writes the Gerbers, assembly files, a KiCad project and 3D models, prices it at several quantities — and keeps every version so you can come back, compare, and go back.

The workbench: copper view, the conversation that produced the board, and its build cost

What you get from one sentence

StageOutput
DesignA structured netlist: parts, packages, nets, assumptions, open decisions, and what the model could not do
PartsEvery component resolved to a real LCSC part number in stock, with price and basic/extended status
ChecksAn electrical rule check with named rules, and pin functions verified against the KiCad symbol library
LayoutPlacement and autorouting (freerouting) on a two-layer board with a ground pour
FabGerbers and drill file (verified by reading them back), BOM and CPL in JLCPCB's format, a .kicad_pcb you can open and edit, VRML 3D models
MoneyCost and stock headroom at 1 / 10 / 25 / 100 boards, from live inventory
MemoryEvery turn saved as an immutable version: diff, restore, fork, label, export

The one rule

Every stage reports what it could not do, and that report is shown next to the board rather than in a log. A board that routes is not the same as a board that works, and the gaps list is the difference. Read What is not guaranteed before you send anything to a fab.

Where to start

  • Install

    Five minutes, one API key, Java for the router.

  • Your first board

    From a sentence to Gerbers, and what to look at along the way.

  • The app

    Projects, the workbench, versions, exports, two devices on one board.

  • The pipeline

    Every stage: what it decides, what it reports, what it cannot promise.

  • Reference

    Every command, endpoint, file and environment variable.

  • Operations

    Running it for real: the server, access, deploying, troubleshooting.

Two kinds of version

The app has a version (soldermask version, semantic, tagged, changelogged). Each project keeps every board it has built as a numbered version on disk. They are different things and both are explained in Versioning and releases.

On this page