Skip to the content
2 layers96.5 × 66 mmRelay, the printed circuit board in 3D

"Compile" kicad PCBs into files for ordering from JLCPCB

Size
96.5 × 66 mm
Copper layers
2
Thickness
1.6 mm
Parts
36
Nets
44
Pads
108
Tracks, vias
210, 11
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
28 Mar 2026
Updated
19 Jun 2026

Overview

Relay is an open-source printed circuit board by limikael, from the limikael/kicad-fab-export repository on GitHub. It is a 2-layer board of 96.5 × 66 mm with 36 parts on 44 nets, routed with 210 tracks and 11 vias.

Its parts include 9 connectors, 6 resistors, 5 diodes, 4 ICs and 4 transistors. It belongs with the home automation and IoT boards of this library.

README

README.md

kicad-fab-export

A scriptable CLI tool for generating JLCPCB manufacturing files directly from a KiCad PCB file.

It is designed for automated workflows and deterministic, CI-friendly PCB exports.

Overview

kicad-fab-export takes a KiCad PCB file (.kicad_pcb) as the single source of truth and generates JLCPCB-compatible manufacturing outputs:

  • bom.csv — Bill of Materials
  • cpl.csv — Pick and Place (Centroid file)
  • gerbers.zip — Gerber fabrication archive

It does not require schematic files or project files.

Key Design Principles

  • PCB file is the source of truth
  • No dependency on .kicad_sch or .kicad_pro
  • Fully scriptable and deterministic
  • Strict validation (fail fast on inconsistencies)
  • Designed for automation pipelines

Component Model

Each footprint placed on the PCB is treated as a potential component.

A footprint is included in outputs only if it has the attribute:

  • lcsc → LCSC part number (required)

Optional attributes:

  • lcscRot → Additional rotation offset applied in CPL generation

Footprints without lcsc are ignored.

Footprint Resolution

kicad-fab-export resolves footprint geometry by loading .kicad_mod files from provided footprint directories.

It doesn't try to resolve these automatically because they are a bit inconsistent from system to system. You probably want to do something like:

bash
kicad-fab-export board.kicad_pcb \
  -F /usr/share/kicad/footprints/ \
  -o ./out

It does however check the project for a fp-lib-table file and reads project specific library paths from there.

Arguments

text
pcb   KiCad PCB file (.kicad_pcb)

Options

text
-o, --output <dir>          Output directory
-F, --footprint-dir <path>  Footprint directory (can be used multiple times)
-h, --help                  Show help

Output

All outputs are written to the specified output directory:

text
bom.csv
cpl.csv
gerbers.zip

bom.csv

  • One row per PCB footprint instance
  • No grouping or aggregation
  • Only footprints with lcsc attribute are included

cpl.csv

  • Pick and place file
  • Includes centroid positions derived from footprint geometry
  • Applies rotation correction using lcscRot if present

gerbers.zip

  • Standard Gerber export archive suitable for JLCPCB manufacturing

Error Handling

kicad-fab-export uses strict validation and will fail immediately on any inconsistency.

Errors include:

  • Missing footprint .kicad_mod files
  • Missing or invalid footprint geometry
  • Invalid footprint library resolution
  • Malformed PCB data
  • Duplicate or inconsistent component data

No partial output is produced on failure.

Example

bash
kicad-fab-export myboard.kicad_pcb -F ./libs -o ./out

Output:

text
out/
  bom.csv
  cpl.csv
  gerbers.zip

Philosophy

kicad-fab-export is intentionally minimal and deterministic:

  • No schematic parsing
  • No netlist dependency
  • No global KiCad environment dependency
  • No grouping or BOM optimization (by design)

Parts

36
QtyValueFootprintReferences
5~Connector_PinSocket_2.54mm:PinSocket_1x02_P2.54mm_VerticalJ5, U5, U6, U7, U8
41kResistor_SMD:R_0603_1608MetricR11, R12, R13, R14
4~Package_TO_SOT_SMD:SOT-23Q1, Q2, Q3, Q4
4~Peabrain:ScrewTerminals_4PJ1, J2, J3, J4
4~Diode_SMD:D_SOD-123D11, D12, D13, D14
4~Relay_THT:Relay_SPDT_SANYOU_SRD_Series_Form_CK1, K2, K3, K4
2~Connector_PinSocket_2.54mm:PinSocket_1x04_P2.54mm_VerticalU3, U4
2~Connector_PinSocket_2.54mm:PinSocket_1x08_P2.54mm_VerticalU1, U2
1330Resistor_SMD:R_0603_1608MetricR4
14.7kResistor_SMD:R_0603_1608MetricR1
1~Diode_SMD:D_SMAD1

The 32 most common of 36 parts.

Similar boards

  • 2 layers65 × 30 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    36 parts1kGPL-3.0
  • 2 layers55 × 70 mmArduino v1, the printed circuit board in 3D

    Arduino v1

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    36 parts915
  • 2 layers50.4 × 24.8 mmLEDboardRev3, the printed circuit board in 3D

    LEDboardRev3

    Architeuthis-Flux/Jumperless

    A jumperless breadboard

    36 parts914
  • 2 layers45.7 × 31.8 mmLEDx16 board, the printed circuit board in 3D

    LEDx16 board

    tardate/LittleArduinoProjects

    a collection of "Little Electronic & Arduino Projects", most involving electronics or an Arduino in one way or another!

    36 parts803MIT
  • 2 layers32 × 24 mmEsp onelayer3, the printed circuit board in 3D

    Esp onelayer3

    cnlohr/colorchord

    Chromatic Sound to Light Conversion System

    36 parts712
  • 2 layers69 × 53.8 mmTUSS4470 shield, the printed circuit board in 3D

    TUSS4470 shield

    Neumi/open_echo

    Open Source echo sounder / depth sounder / SONAR for bathymetry and research. Arduino based and compatible.

    36 parts530
  • 2 layers99.1 × 53.3 mmABSIS Mega, the printed circuit board in 3D

    ABSIS Mega

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    36 parts431
  • 2 layers16.1 × 119 mmConnectorL, the printed circuit board in 3D

    ConnectorL

    thpoll83/PolyKybd

    PolyKybd

    36 parts411CERN-OHL-W-2.0

Questions

How big is the Relay PCB?

It measures 96.5 × 66 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Relay use?

36 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Relay KiCad files?

From the limikael/kicad-fab-export repository on GitHub, at the commit this page was made from: the board is spec/relay.kicad_pcb and its schematic spec/relay.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Relay design in my own project?

Its repository states no licence, so its author keeps all rights: ask limikael before reusing the design.