circuit-json-to-gerber

August 22, 2026 ยท View on GitHub

Convert a Circuit JSON to Gerber/Excellon files.

Installation

# Global installation for CLI usage
npm install -g circuit-json-to-gerber

CLI Usage

Convert a circuit JSON file to Gerber/Excellon files:

# Basic usage - outputs to input.gerbers.zip
circuit-to-gerber input.circuit.json

# Specify custom output file
circuit-to-gerber input.circuit.json -o output.zip

The output ZIP file will contain:

  • Gerber files (*.gbr) for each layer
  • Plated drill file (plated.drl)
  • Unplated drill file (unplated.drl)

Library Usage

import { convertCircuitJsonToGerberFiles } from "circuit-json-to-gerber"

const files = convertCircuitJsonToGerberFiles(circuitJson)

// The result is filesystem-neutral and includes Gerber and Excellon files.
// Write it to disk, add it to a ZIP, or store it with any file API.
for (const [fileName, contents] of Object.entries(files)) {
  await output.write(fileName, contents)
}

Lower-level command conversion and stringification APIs remain available when custom layer processing is needed.

References