How cimos/kicad-customdesignrules works
Project type and purpose
• This is an open-source configuration library for KiCad’s PCB Editor (“KiCad-Custom-Design-Rules”).
• It supplies vendor-specific design-rule sets (JLCPCB, PCBWay) as KiCad Custom Rules (.kicad_dru files) that integrate into KiCad’s Design Rules Checker (DRC).
File structure
• Top-level:
• JLCPCB/
– JLCPCB.kicad_dru (custom rule definitions)
– JLCPCB.kicad_pcb, .kicad_pro, .kicad_sch (example project files)
• PCBWay/
– PCBWay.kicad_dru (vendor rule definitions)
– PCBWay.kicad_pcb, .kicad_pro, .kicad_sch
• README.md
• No source code or build scripts—just configuration files for KiCad.
• Each directory bundles: rules + sample KiCad project metadata.
README
• Describes how to copy a .kicad_dru into your own KiCad 8.0 project folder.
• Explains DRC integration and points to JLCPCB & KiCad documentation.
Main components
a. User’s KiCad Environment (UI)
– “PCBnew” Editor → loads Custom Rules via File > Board_Setup > Design Rules
– DRC Engine (built into KiCad)
b. Vendor Rule Sets (Configuration Store)
– File system directories: /JLCPCB/*.kicad_dru, /PCBWay/*.kicad_dru
– These files define geometry constraints, clearance rules, layer checks
c. Sample KiCad Project Files
– .kicad_pcb, .kicad_sch, .kicad_pro (illustrate how vendor rules apply)
d. External Documentation
– JLCPCB manufacturing capabilities (web link)
– KiCad Custom Rules docs
Relationships and interactions
• At startup or on demand, the PCB Editor scans project folder for *.kicad_dru
• When the user runs “Design Rules Checker,” the DRC Engine:
1. Reads vendor rule definitions from the .kicad_dru file
2. Analyzes the loaded .kicad_pcb data (traces, pads, zones)
3. Emits PASS/FAIL results back into the UI
• The user can switch between JLCPCB and PCBWay rules by selecting the respective .kicad_dru file.
Architectural patterns and design principles
• Plug-in/configuration-driven: The core ("KiCad PCBnew + DRC Engine") stays unchanged; behavior is driven by external rule files.
• Separation of concerns:
• Rule definitions = configuration layer
• DRC Engine = processing layer
• KiCad UI = presentation layer
• Extensibility: To add a new vendor, drop a new folder + .kicad_dru. No code changes required.
Technologies and artifacts
• KiCad PCBnew (v8.0)
• Custom Design Rules (.kicad_dru format)
• Example PCB Project Files (.kicad_pcb, .kicad_sch, .kicad_pro)
• Markdown README linking to external docs