Footprints Reference
Footprint specifications, KiCad integration, and custom footprints
Overview
Footprints define the physical pad layout where components are placed on a PCB. tscircuit supports standard footprints, KiCad footprints, and custom footprints.
Footprint Types
| Footprint Type | Description |
|---|---|
| smtpad | Surface-mount pad |
| platedhole | Plated through-hole |
| footprint-elements | Inline footprint elements |
| footprinter-strings | Footprint string format |
| kicad-footprints | KiCad library integration |
Silkscreen Elements
| Element | Description |
|---|---|
| silkscreentext | Text on silkscreen |
| silkscreenline | Line on silkscreen |
| silkscreenrect | Rectangle on silkscreen |
| silkscreenpath | Path on silkscreen |
| silkscreencircle | Circle on silkscreen |
Fabrication Notes
| Element | Description |
|---|---|
| fabricationnotetext | Manufacturing text |
| fabricationnoterect | Manufacturing rectangle |
| constraint | Design constraints |
Common Footprint Strings
| Footprint | Description |
|---|---|
0402 | 0402 SMD resistor/capacitor |
0603 | 0603 SMD component |
0805 | 0805 SMD component |
1206 | 1206 SMD component |
soic8 | 8-pin SOIC package |
qfn32 | 32-pin QFN package |
dip8 | 8-pin DIP package |
usb-c | USB-C connector |
pushbutton | Push button |
Using KiCad Footprints
tsx
// Use KiCad footprint directly <chip name="U1" footprint="kicad:Resistor_SMD/R_0402_1005Metric" />
Custom Footprint Example
tsx
<chip
name="U1"
footprint={
<footprint>
<smtpad
portHints={["1"]}
pcbX="-1mm"
pcbY="0mm"
width="0.5mm"
height="0.5mm"
shape="rect"
/>
<smtpad
portHints={["2"]}
pcbX="1mm"
pcbY="0mm"
width="0.5mm"
height="0.5mm"
shape="rect"
/>
<silkscreenpath
route={[
{ x: -1, y: -0.5 },
{ x: 1, y: -0.5 },
]}
/>
</footprint>
}
schPortArrangement={{
leftSide: { direction: "top-to-bottom", pins: [1] },
rightSide: { direction: "top-to-bottom", pins: [2] }
}}
/>
Related Skills
| Skill | Description |
|---|---|
| Components | Component elements |
| Guides: Importing | Importing from KiCad/JLCPCB |
| Guides: KiCad | KiCad integration |