What it does and how it connects
circuit-json-to-gerber converts Circuit JSON to Gerber and Excellon files. It runs as a CLI (circuit-to-gerber input.circuit.json) or as a library through convertCircuitJsonToGerberFiles, which returns a filesystem-neutral map of file names to contents that the caller can write to disk, zip, or store any other way.
The CLI output is a zip holding Gerber files for each layer plus plated and unplated drill files. Lower-level command conversion and stringification APIs remain available when custom layer processing is needed.
The README cites the Gerber Format Specification (2022) and the Excellon Drill Format Specification as its references. It is the Gerber export step for designs built as Circuit JSON in the tscircuit toolchain.
Alternatives
Compare side by side- footprinter
The DSL and micro-builder that creates PCB footprints for tscircuit, rather than the writer that turns Circuit JSON into Gerber files.
- tscircuit
The full tscircuit design system in TypeScript and React, rather than the Gerber export step alone.
- kicad-mcp-pro
An MCP server that exports manufacturing files through KiCad, rather than a Gerber writer for Circuit JSON.
- DeepPCB
A cloud routing service for an already placed board, rather than a Gerber writer for Circuit JSON.
Recurring errors it addresses
Error Index entries this tool is built to reduce or work around.
- Rounded rectangle USB-C plated pads came out of Gerber export with sharp corners in both copper and soldermask, losing the 0.2 mm corner radius.Error Index
- KiCAD-MCP-Server's export_gerber returns success: true and lists all 24 layers as exported, but writes no .gbr files: PlotLayer draws into a plot file that was never opened with OpenPlotfile, returns False unchecked, and only the drill files (from a separate kicad-cli call) land in the folder. An agent reading the response would report the fab package ready when the folder is empty.Error Index
- A user asks for a Gerber check after finding PCB files where the board profile didn't follow the drawn keepout lines. "Some fabs might require the board profile to be specified using the keep-out lines," and some designers don't know their tool's features well enough to set it. A handoff error that only a fab or a dedicated checker catches.Error Index
Sources
Not verified
- Pricing: none stated on the repo.
- No independent user voice found: the repo has no public non-PR issues listed via the API.
- No GitHub releases exist, so latest release fields are null.
Last verified November 6, 2026. Listings are informational. The evidence score measures public, verifiable evidence and is not an endorsement or a compatibility claim.