Built-in Elements

The built-in elements are the JSX primitives used to describe a tscircuit design. Start with a <board />, add real parts such as <chip />, <resistor />, and <connector />, then connect them with nets and traces.

Migrating older examples

Older snippets may mention a <bug /> element. Use <chip /> instead. It is the supported general-purpose element for ICs, modules, sensors, and other single-package parts with named pins or custom footprints.

First Elements To Learn

Element	Use it for
<board />	The root circuit and PCB area. It owns board size, layer count, routing settings, and global board constraints.
<chip />	ICs, modules, sensors, and other single-package parts with custom pins, symbols, or footprints.
<trace />	Electrical connections between component pins, ports, and named nets.
<net />	Shared named connections such as GND, VCC, SDA, or RESET.
<resistor />	Pull-ups, pull-downs, dividers, current limiting, and generic fixed resistance.
<capacitor />	Decoupling, filtering, timing, and bulk capacitance.
<connector />	Cable, board-to-board, USB, M.2, and custom connectors.

Circuit Structure

Element	Use it for
<board />	Root board size, PCB outline, stackup, routing, and global constraints.
<group />	Grouping components so they can move or be referenced together.
<subcircuit />	Reusable circuit sections with local layout and routing context.
<port />	Named connection points inside custom components, footprints, and reusable groups.
<net />	Named electrical nets shared across multiple components.
<netlabel />	Schematic labels for named nets.
<trace />	Explicit electrical connections and optional manual PCB paths.

Components

Element	Use it for
<chip />	General-purpose chips, modules, sensors, and custom single-package parts.
<resistor />	Fixed resistors, pull-ups, pull-downs, and current limiting.
<capacitor />	Decoupling, filtering, timing, and bulk capacitors.
<inductor />	Power filtering, LC filters, and switching regulator magnetics.
<diode />	Directional current flow, clamps, flyback paths, and rectification.
<led />	Indicator LEDs and light-emitting diode symbols.
<fuse />	Resettable or one-time overcurrent protection.
<crystal />	Quartz timing references.
<resonator />	Ceramic timing references.
<switch />	Generic switch behavior.
<pushbutton />	Momentary user inputs.
<potentiometer />	Adjustable resistance and voltage divider controls.
<transistor />	Generic transistor symbols and packages.
<mosfet />	MOSFET power and signal switches.
<opamp />	Operational amplifier circuits.
<battery />	Battery sources and battery-holder style components.
<voltagesource />	Ideal voltage sources for schematic and simulation contexts.
<voltageprobe />	Simulation probes for reading voltages.

Connectors And Access Points

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

PCB And Footprint Detail

Element	Use it for
<footprint />	Custom footprints built from pads, holes, and geometry.
<cadmodel />	3D models attached to packages.
<cadassembly />	Grouped CAD models for a component or assembly.
<hole />	Mechanical, mounting, and through-hole footprint holes.
<via />	Copper layer transitions for routed traces.
<copperpour />	Copper fill regions tied to a net.
<coppertext />	Text rendered as copper.
<cutout />	Board slots, routed openings, and material removal.
<fiducial />	Pick-and-place optical reference marks.
<courtyardrect />	Rectangular component courtyard boundaries.
<courtyardcircle />	Circular courtyard boundaries.
<courtyardoutline />	Custom courtyard outlines.

Schematic Drawing And Notes

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 and custom symbols.
<schematicsection />	Visual schematic grouping.
<schematictable />	Tabular schematic annotations.
<pcbnotedimension />	PCB dimension callouts.
<pcbnoteline />	PCB line annotations.
<pcbnotepath />	PCB path annotations.
<pcbnoterect />	PCB rectangular annotations and keepout notes.
<pcbnotetext />	PCB text annotations.

Analysis And Routing

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

When you are unsure where to start, use <board />, <chip />, <net />, and <trace /> first. Those four elements cover the structure, component, named connection, and wiring concepts that most examples build on.