Built-in Elements

The built-in elements are the JSX primitives that make up a tscircuit design. Use this page as a map: start with <board />, place real parts like <chip />, <resistor />, and <connector />, then add routing, footprint, schematic, and annotation elements as the design needs more detail.

If you are looking for the old <bug /> element, use <chip /> instead. <chip /> is the general-purpose component for ICs, modules, and other single-package parts with custom pin labels or footprints.

Core Circuit Structure

Element	Use it for
<board />	The root PCB area, board size, layout, and autorouting settings.
<group />	Grouping components so they can be laid out and referenced together.
<subcircuit />	Reusable circuit sections with their own layout and routing context.
<port />	Named connection points inside custom components, symbols, and footprints.
<net />	A named electrical net that multiple component pins can connect to.
<netlabel />	Schematic labels that expose or clarify named nets.
<trace />	Explicit electrical connections between ports or selectors.

Components

Element	Use it for
<chip />	General-purpose ICs, modules, sensors, and any single-package component with custom pins.
<resistor />	Fixed resistors, pull-ups, pull-downs, and current limiting.
<capacitor />	Decoupling, filtering, timing, and bulk capacitance.
<inductor />	Power filtering, LC filters, and switching regulator magnetics.
<diode />	Directional current flow, flyback paths, clamps, and rectification.
<led />	Indicator LEDs and light-emitting diode symbols.
<fuse />	Resettable or one-time overcurrent protection.
<crystal />	Quartz crystal timing references.
<resonator />	Ceramic resonator timing references.
<switch />	Generic switches and user-controlled circuit breaks.
<pushbutton />	Momentary button inputs.
<potentiometer />	Adjustable resistors and voltage dividers.
<transistor />	Generic bipolar transistor symbols and packages.
<mosfet />	MOSFET switches and transistor-level power control.
<opamp />	Operational amplifiers with standard op-amp pin behavior.
<battery />	Battery sources and battery holder style components.
<voltagesource />	Ideal voltage sources for schematic and simulation contexts.
<voltageprobe />	Simulation probes for measuring circuit voltage.

Connectors And Breakouts

Element	Use it for
<connector />	USB, M.2, board-to-board, cable, and custom connector parts.
<pinheader />	Standard through-hole or surface-mount pin headers.
<jumper />	Removable or configurable jumper links.
<solderjumper />	PCB solder jumpers and configurable copper bridges.
<testpoint />	Probe pads for test, programming, and debug access.
<breakout />	Fan-out areas where signals leave a dense component.
<breakoutpoint />	Individual breakout targets inside a <breakout />.

PCB And Footprint Detail

Element	Use it for
<footprint />	Custom footprint definitions built from pads, holes, and geometry.
<cadmodel />	3D models attached to packages or assemblies.
<cadassembly />	Grouping CAD models that belong to a component or assembly.
<hole />	Mechanical, mounting, and through-hole footprint holes.
<via />	PCB layer transitions for routed traces.
<copperpour />	Copper fill regions tied to a net.
<coppertext />	Text rendered as copper on the PCB.
<cutout />	Board slots, keep-outs, and routed material removal.
<fiducial />	Pick-and-place optical reference marks.

Courtyards

Element	Use it for
<courtyardrect />	Rectangular component courtyard boundaries.
<courtyardcircle />	Circular courtyard boundaries.
<courtyardoutline />	Custom courtyard outlines.

Schematic Drawing

Element	Use it for
<symbol />	Custom schematic symbols composed from drawing primitives.
<schematicline />	Straight schematic drawing lines.
<schematicpath />	Multi-segment schematic paths.
<schematicarc />	Arc segments in custom symbols and drawings.
<schematiccircle />	Circular schematic drawing primitives.
<schematicrect />	Rectangular schematic drawing primitives.
<schematictext />	Text labels inside schematics or custom symbols.
<schematicsection />	Visual schematic sections and group boundaries.
<schematictable />	Tabular schematic annotations.

PCB Notes

Element	Use it for
<pcbnotedimension />	Dimension callouts on PCB documentation layers.
<pcbnoteline />	Line annotations on PCB documentation layers.
<pcbnotepath />	Path annotations on PCB documentation layers.
<pcbnoterect />	Rectangular PCB note annotations.
<pcbnotetext />	Text annotations on PCB documentation layers.

Analysis And Routing

Element	Use it for
<analogsimulation />	Analog simulation setup and outputs.
<autoroutingphase />	Inspecting and controlling stages of autorouting.