Workbench
The workbench shows one version of one board. Here you move parts, draw tracks, change how the board is built, and rebuild it.
The address is where you are: the board, the version, the view, the pick, the drawer tab and the findings you are reading. A reload, a shared link and Back land in the same place. See The address.

The screen
The board sits in the middle, and nothing covers it. Five regions surround it.
| Region | What it holds |
|---|---|
| Header | Three zones. Left: the project name (click to rename it) and the version menu. Middle: the views Copper, 3D and Schematic. Right: the poll and Export, with Rebuild, Accept and Discard when there is something to decide. |
| Left | Thread: your messages, the replies and the build log. Library: blocks and parts you can add. |
| Stage | The board, its rulers, the findings and the layers control in its corner. |
| Right | The inspector. With nothing picked it shows the board: its checks, Why, then its facts. It also holds the board's findings. Pick a part, a net or a track and it shows that. |
| Seam | The bar under the stage. It starts with the drawer's tabs: Chain, Scope and Cost. Then comes the readout. |
| Bottom | The drawer, under the seam. It is shut until you open one of its tabs. |
- The thread and the inspector run the full height of the window. The stage, the seam and the drawer stack between them.
- Fold any region with the chevron in its title bar, or with Bracket-left, Bracket-right and Backslash. Each browser remembers what you folded.
- Cmd+Backslash gives the board the whole window. Both columns and the drawer fold, and the header and the foot stay. Press it again to bring back what was open.
- The inspector's title is a breadcrumb, such as Board › Findings › J1. Click a step to go back to it, or press Esc to go back one.
- The inspector opens on the board's checks, then its Why cards.
- The inspector opens by itself when you pick something.
- The version chip opens the version menu. Picking a version shows it, and your next message edits it.
- On an older version, the chip says which version is newest, such as v004 of v006. Latest takes you there.
- On a phone, the inspector is the Board tab of the details sheet, and the findings are its Findings tab. Layers sits beside the poll's pill.
The poll
The poll says whether the board works. It is one pill in the header, beside Export, such as NO-GO Copper 4 err.
It shows the board's word and what holds it:
| Word | Means |
|---|---|
| GO | Every station passed. |
| NO-GO | At least one station holds. The board does not work as built. |
| UNJUDGED | Nothing failed, but a check the verdict needs did not run. |
A board built before verdicts existed also reads UNJUDGED, with no verdict under the word. Rebuild it to judge it.
The inspector opens with the checks: one chip for each part of the pass rule.
| Station | Passes when |
|---|---|
| Parts | Every part resolved |
| Nets | No net or pin the design asked for was dropped |
| ERC | The electrical rule check ran and found no errors. Warnings show here but do not hold it. |
| Route | Every pin is reached. It reads off when routing was not asked for. |
| Copper | KiCad's DRC judged the finished copper and found no errors, and no net's copper is too narrow for its current |
A check that holds is red and says what it found, such as Copper 4 err. A check that passed is a green dot and its name.
Copper too narrow for its net's declared current reads Copper 2 hot. It holds when the copper would rise 100 °C or more. A rise past 20 °C is an advisory.
After the stations, a chip counts the advisories when there are any. These are what the build reported and the verdict does not read, such as unverified footprints.
- Click the pill, or a check that holds, to open Why. A check that passed opens what it checked in the findings.
- Click Advisories to open their list in the findings. All findings, the last chip, opens every group.
- The poll uses the rule the evaluator scores with. The word here and the pass rate on the benchmarks page cannot disagree.
- On a phone, the pill sits under the header. The checks are in the details sheet.
Why
With nothing picked, the inspector starts with one card for each thing that keeps the board from GO. There are no cards when the board is GO.
Each card says:
- which station holds, and which card of how many it is when there is more than one
- what was found and where, in one sentence
- the facts: how many errors, the cause, the version it started in, and what found it
- the actions that can clear it, with the likeliest one filled
- which actions cannot help, and why
The actions depend on the cause:
| Cause | Actions |
|---|---|
| A part's own footprint, such as pads too close to the part's own holes | Ask for another part, browse the catalogue, show it on the board |
| Two parts too close together | Show it on the board, place again, ask to move them apart |
| Copper where it meets a part | Route again, show it on the board, ask about it |
| Pins the router did not reach | Route again, show the net, place again, ask about the layout |
| Copper too narrow for its net's current | Route again, show the findings |
| An electrical rule error | Ask to fix the circuit, show the findings |
| Parts that did not resolve | Ask for parts that resolve, browse the catalogue |
| Connections that were dropped | Ask to fix the connections |
| A check that did not run | Rebuild to judge it |
An Ask action writes a question in the thread's message box, scoped to the parts it names. Nothing is sent until you send it.
Keys
| Key | Does | View |
|---|---|---|
| 1 2 3 | Switch to Copper, 3D or Schematic | Any |
| Tab | Next view (Shift+Tab for the previous one) | Any |
| Esc | Let go of the selection and the finding you are looking at. With nothing picked, close the findings. | Any |
| Cmd+K | Open the command bar | Any |
| Question | Show the keys | Any |
| L | Open or shut the layers control | Any |
| Bracket-left / Bracket-right | Fold the thread, fold the inspector | Any |
| Backslash | Open or shut the drawer | Any |
| Cmd+Backslash | Give the board the whole window, or bring the panels back | Any |
| N / Shift+N | Look at the next or the previous finding on the copper | Any |
| Cmd+Z / Shift+Cmd+Z | Undo / redo a move, a turn, a flip or a track you drew | Any |
| Del or Backspace | Delete the picked track you drew, or remove the picked part | Any |
| Arrow keys | Move the picked part one grid step (with Shift, ten) | CU |
| R / Shift+R | Turn the picked part a quarter turn, one way or the other | CU |
| F | Flip the picked part to the other side of the board | CU |
| Page Up / Page Down | Make top or bottom copper the active layer | CU |
| X (or W) | Start or stop drawing tracks | CU |
While you draw a track:
| Key | Does |
|---|---|
| V | Drop a via and carry on on the other layer |
| / or Space | Flip the corner: straight first, or diagonal first |
| Backspace | Take back the last corner |
| Enter, double-click or right-click | Finish the track here |
| Esc | Drop the track. Press it again to stop drawing. |
| Alt + click | Lift a track you drew earlier |
Pointer and touch:
| Gesture | Does |
|---|---|
| Drag bare board | Pan |
| Shift + drag | Pan from anywhere, even while drawing |
| Scroll | Zoom about the pointer |
| Double-click bare board | Fit the board to the window |
| Two-finger pinch | Zoom, on a touch screen |
| Alt while dragging a part | Stop the part snapping |
The command bar
Press Cmd+K (Ctrl+K on Windows and Linux) and type what you want.
It reaches the board's parts, nets and findings, the views, the layers and the versions. It also runs Route again, Place again, Rebuild, Simulate and the file downloads, and searches the catalogue for what you typed.
- Words match in order, each as the start of a word or a run of letters.
- Use the arrow keys to move, Enter to run, and Esc to close.
Copper
The copper view draws the board the way the fab will make it. It shows the pads, the top and bottom copper, vias, silkscreen and reference designators.
Inner layers are not drawn
On a four-layer board, the copper view and the 3D view draw only the two outer layers. Tracks and fills on In1.Cu and In2.Cu do not show, and Layers has no switch for them. The Gerbers and the KiCad file carry every layer.
The palette switch at the foot of Layers changes how it looks:
- Editor (the default) looks like a PCB editor. Copper is translucent, so crossings stay visible.
- Board looks like the finished board, with solder mask and gold, as the 3D view draws it.
Before you click, the part under the pointer is outlined. The outline is exactly what a click will pick. Tiny parts get a target about 12 pixels wide, so they stay easy to grab.
One copper layer is active. It takes new tracks and draws in front, and the other layer fades. Switch with Page Up / Page Down, or click a layer swatch.
The grid step changes with the zoom, from 0.1 mm to 25 mm. Every fifth line is brighter. Boards built before 15 Sep 2026 have no silkscreen drawings, so each part draws as a plain box.
The picked part and a picked track glow in the selection colour. So does a track while you draw it. Nothing else on the board glows.
Rulers
Rulers run along the stage's top and left edges, in millimetres.
- They read from the board's bottom-left corner, in the same frame as the readout.
- Their ticks are the grid's lines, with a figure on every fifth.
- A white mark on each ruler follows the pointer.
- The picked part's extent shows on both rulers in the selection colour.
- The Board palette has no grid and no rulers. A phone has no rulers either.
Move a part
- Drag the part. Or pick it and press an arrow key to move it one grid step.
- A pad within 1.2 mm of a pad on the same net snaps to it. Hold Alt to stop the snap.
- The part gets a pin mark in its corner, shown while it is picked. Turn on Pins in Layers to see every pinned part. The position saves a second after you stop.
- Press Rebuild. The placer keeps your part where it is and arranges the rest around it.
A move does not edit the built board. It writes a pin into the design's constraints, and every later build keeps that part where you put it.
Until you rebuild, the board shows a preview:
- Tracks on the part's nets fade, and its ratsnest appears. Poured nets have no ratsnest.
- Track ends on the part's pads follow the part. The router decides the real copper at the next build.
- A bar in the header says what changed, such as 1 part moved, with Rebuild beside it. Hover over it for the whole sentence.
Only a rebuild makes a new version.
Turn or flip a part
- R turns the picked part a quarter turn. Shift+R turns it the other way.
- F flips it to the back of the board, and back again. On a touch screen, use to back / to front in the panel.
Some parts stay on top, where a person can reach them: connectors, switches, LEDs, modules and displays. A part with leads through the board cannot flip either, because it is on both sides already. If a flip is refused, the hint line says why.
A part on the back draws with a dashed outline and bottom-copper pads. In 3D it hangs under the board.
Pick, keep or delete a track
Click a track to pick it. The panel shows its net, layer, width and length, and whether you or the router drew it.
- A track you drew: press Del, or click Delete this track.
- A track the router drew: the next build routes it again, so deleting it would change nothing. Click Take this track over instead. The track is copied into
constraints.tracks, and the next build keeps it. It is then yours to delete or redraw.
Where things overlap, a click picks a part first, then a track you drew, then a router track.
Draw a track
- Press X. Every pad gets a ring you can land on.
- Press on a pad and drag to where the track should end. Or click a pad, then click once for each corner.
- Finish on another pad of the same net, or on that net's existing copper.
The track takes the net and width of the pad it starts from. Each click lays two segments: one straight and one at 45°. You can also start from existing copper. That is how you fix a track the router got half right, or finish a net by hand.
Your track is an input to the next build, the way a pin is. It is saved in
constraints.tracks, and the router
must route around it. A track can stop halfway: the router finishes the net.
The build's notes say which of your tracks it kept. The gaps list names any
track it could not keep.
Layers and overlays
The Layers control sits in the stage's top corner and says how many layers are on, such as 6/8. Click it or press L. Press Esc or click outside it to shut it.
It opens a grid of switches: top copper, bottom copper, pads, vias, silkscreen and the ratsnest, each with a count. Findings, Pins and Congestion join them when the board has them. The ratsnest, Pins and Congestion are off by default. A switch that is off is dashed. Below the grid, click a net in Nets to isolate it, and everything else dims. View switches the palette.
The stackup and the fabrication sheet are facts about the board, so they are in the inspector, folded under the board's facts. The stackup's bands still switch copper and silkscreen.
Congestion is the predicted congestion. It shows where the routability model expected copper before routing. It also rings the pins the model expected the router to miss. Turn it on over the routed board to compare the two.
Findings on the copper
The Findings overlay marks each place KiCad's DRC found a problem in the copper. It is on by default, and it appears only when there is something to mark.
- A white reticle with a red glow is an error that holds the Copper station.
- An amber reticle is an advisory, such as a thermal relief short of spokes.
- Findings on the same pads share one reticle. Its numbers show when you zoom in or look at it.
To look at one:
- Click Copper in the poll, press N, or click Show on the board under a finding.
- The board flies to the part, and the part is picked.
- A crosshair runs through the finding, with its position in millimetres and what DRC found.
- Press N for the next one, or Esc to let go.
The reticles take no clicks. A click on one picks the part under it.
A version built before 8 Oct 2026 kept no positions. When its copper holds, the workbench asks KiCad's DRC again on the version's own file. That takes a few seconds once, and nothing in the version is written.
3D

The 3D view renders the finished board: FR4, glossy mask, gold pads and silkscreen. Parts use their vendor's 3D model where one exists (see KiCad and 3D models). Other parts are built from their package's outline.
- The pill at the bottom sets what a drag does: Orbit, Pan or Zoom. Frame fits the board.
- Shift + drag pans, and the wheel zooms.
- The axis ball in the corner turns the camera. Click X, Y or Z for a side view, the dot opposite for the other side, or the centre to reset.
- On a phone, Tilt orbits the board as you tilt the phone.
- On a four-layer board, the inner copper is not drawn.
Schematic

The schematic is a real KiCad sheet, drawn with KiCad's own symbols. Power and
ground are port symbols. The <board>.kicad_sch file in the version comes from
the same record, so KiCad opens the sheet you see.
The server lays it out (soldermask/sheet.py):
- Signals flow left to right, from power and inputs to outputs and indicators.
- Pull-ups sit above the chip they serve. Pull-downs and decoupling capacitors sit below it.
- A short net between two nearby pins is drawn as a wire. Every other net gets a label at each pin.
Two marks show real gaps in the design:
- A no-connect X on a pad means the pad is on no net.
- An open circle with a net name means the net has only one pin.
Arrange the sheet
- Drag a symbol to move it. Its wires redraw, and its helpers move with it: an LED with its resistor, decoupling with its chip. The position is saved in
constraints.sheet. - Drag a trunk up or down. A trunk is a net of three or more nearby pins on one horizontal lane. The lane is saved in
constraints.wires. A net drawn as labels has no lane to move. - Symbols snap to KiCad's pin grid. Cmd+Z undoes.
- Shift + drag pans, scroll zooms, and double-click shows the whole sheet.
Blocks
Library → Blocks lists circuit fragments. Examples are a regulator with its capacitors, or a CAN transceiver with its termination. A block comes from one of two sources:
| Source | Where it comes from | Its grounds for trust |
|---|---|---|
| Mined | Finished boards from the corpus | It appears on at least three boards. The row shows how many. |
| Authored | Diode's Zener reference designs | A person wrote it against the datasheet. It has no board count. |
Where both sources describe the same part, the authored block is the one listed.
Each row also shows the block's ports and whether it builds. A block builds when its parts resolve and it passes ERC. A block nobody has checked says unchecked. Blocks that do not build are still listed, with the reason. The usual reason is a part that is no longer stocked. Blocks that build come first.
Add to the board merges the block in. A port with the same name as one of your nets joins that net. The change arrives as a proposal.
Parts
Library → Parts searches JLCPCB stock by part number or description, for
example AMS1117-3.3, 10k 0603 or USB-C. It lists only parts in stock.
Each row shows the package, unit price and stock. It also says where the footprint comes from: this pipeline's own drawing, or the vendor's unverified drawing for that exact part.
To add a part:
- Click Choose… on its row.
- Check its kind, value and purpose. The kind sets which electrical rules apply, so it stays blank when the catalogue is unclear.
- Pick a net for each pin. The list offers only pin names the build will accept.
- The part arrives as a proposal.
The part is pinned by its LCSC code, so the build uses exactly that part. You can leave its pins unwired. The build then reports an ERC error naming the part, and you can wire it later here or in the chat.
Proposals
A change to a board that already exists arrives as a proposal. A bar above the board says what accepting it would do:
Proposed · changes R1 · 1 net change: GND · 1 fewer ERC error · +$0.40 a board [Discard] [Accept]
The board under the bar is the proposal, already built and routed.
- Accept makes it the next version.
- Discard puts the board back as it was.
Nothing is written to the project until you press one. A proposal survives a reload.
Scope a change by selecting first. Pick a part, a net, or several parts with Shift-click. They show as chips under the message box. The model may change or remove only what is in scope, and it may add anything. So if you ask about the LED circuit, the regulator stays.
With nothing selected, a change can touch the whole board. A project's first board skips the proposal step.
The build log
While a build runs, the thread shows one row per stage:
Thinking · Resolving parts · Simulating · Placing · Routing · Writing fab files · Checking stock · Fetching 3D models · Saving
The running stage shows a clock. Finished stages show their time, and stages still to come are dimmed.
When the build finishes, the log stays under the reply. Each row says what its stage produced: parts resolved, placements rated, what the router did, the price and the version. Every log folds to one line, such as Built · 8 steps · 1m 12s, with a bar showing where the time went. Click it to open the rows.
The log is saved with the turn. A reload or a second device shows the same log. A page opened mid-build picks up at the current stage.
Placing, live. While the placer runs, the board gives way to six small boards, one per anneal. You watch the parts move and settle. Each board then shows the model's rating, and the one the router tries first is outlined. The rating is a guess, and the router decides. Within one board, the model's order is close to chance (see Routability).
The thread opens on your last message. Everything before it folds into one line, such as Show 6 earlier versions. Click it to open the history.
The thread has five kinds of row:
| Row | Looks like |
|---|---|
| Your message | A bubble on the right |
| A reply | Plain text on the left. A paragraph the thread has already shown, such as the board's description, is not repeated. |
| A version | A card under the reply. The version on screen has an accent edge, its word, what holds and its price. Any other version is its light, id and word. Click it to open it. |
| A build the app started | One line, such as Route again → v006 · NO-GO · 5.3s. Click it for the note, the log and the version's row. |
| An action the app started: Rebuild, Route again, Place again, or a file read in | A quiet line in small grey text |
| A turn that failed | Red, with the reason. It stays after a reload. |
When a version turned away from GO, a line under its row says how and why. An example is GO → NO-GO: Copper 4 err, hole clearance. 2 unplated holes in the file, 0 in v003. A turn to GO needs no line: the row's own word says it. The version menu shows every turn, unfolded under its version.
A build that failed its checks and was revised makes two versions. It still shows as one reply, marked revised from v001.
The launch sequence. While a build runs, the poll's pill shows BUILDING with a clock and the stage that is running. The thread's log has every stage. When the build lands, the poll returns.
The message box says when it cannot send, for example when the server has no model. While a build runs, the thread stays where you scrolled it.
The inspector and the drawer
The inspector is the right column. It shows one thing at a time, and its breadcrumb says which.
| Picked | The inspector shows |
|---|---|
| Nothing | The board: its checks, the Why cards, then Generation, Board and Parts, then the stackup and the fabrication sheet, each folded to one line |
| Nothing, with the findings open | The findings |
| A part | The part card, led by any Why card that names the part |
| A track | The track's layer, width and net |
- Generation holds the prompt, the model, tokens, cost and the model's assumptions.
- Board holds parts, pads, nets, copper length and vias.
- Parts lists every reference designator. Click one to pick that part.
The part card leads with the reference, and the buttons that turn the part or remove it. Its facts are the part number, package, JLC type (Basic or Extended), price, stock, position and rotation. It lists each pin with its name and net. On a phone it is in the details sheet.
The findings
The findings are every check on the board, in groups. They open in the inspector, and its breadcrumb reads Board › Findings.
| To | Do this |
|---|---|
| Open every group | Click All findings, the last of the board's checks |
| Open one group | Click its check, the pill when the board is GO, or a box in the chain |
| Move between groups | Click a group, or press ↑ and ↓ |
| Look at what a finding names | Click its reference or net. Click Findings in the breadcrumb to come back. |
| Close them | Click Board in the breadcrumb, or press Esc with nothing picked |
The findings start with one line in the poll's words, such as NO-GO. Copper 4 err. The groups follow, each with its count: Verdict, Electrical, Routing, Stock, Advisories, Precedents and Live sync. The picked group's findings show under the list and scroll on their own. The findings open on the worst group.
Under Routing, each place on the copper is one row, such as J1: 4 hole clearance, 0.171 to 0.213 mm against 0.25 mm. Its Show on the board flies to it. On a phone the findings are the details sheet's Findings tab, and the groups fold.
Advisories lists everything the build reported that the verdict does not read. Its count is the one on the poll. It holds three kinds of line:
- What the design asked for and could not carry, the model's unsupported list.
- The build's gaps, such as unresolved pins, substitutions, unverified footprints and copper that runs warm.
- The build's notes, such as the physics review, the datasheet's layout rules and JLCPCB's fabrication limits.
The drawer
The drawer holds the build: its chain, its scope and its cost. It opens under the seam, the bar below the board.
| To | Do this |
|---|---|
| Open a tab | Click it in the seam, or press Backslash for the last one |
| Shut the drawer | Click the open tab again, or press Backslash |
| Size it | Drag the seam up or down. Drag it to the bottom to shut it. |
| Make it tall | Double-click the seam. Double-click again to put it back. |
Cost shows the price per board on its tab. The drawer opens at the size you last gave it.
| Tab | Holds |
|---|---|
| Chain | The build's stages and knobs |
| Scope | The simulation traces |
| Cost | Cost and stock at 1, 10, 25 and 100 boards, and a table of every part |
On Cost, catalogue means stock was read from the parts catalogue on disk,
which is the default. live means a parts server was asked, with
SOLDERMASK_PARTS=jlcsearch. Anything that blocks a run is listed under the table.
Remove a part
Click Remove, or pick the part and press Del. The workbench builds the board without the part and offers it as a proposal.
- Nothing is lost until you press Accept.
- A net left with one pin goes too. The proposal names those nets.
- Shift-click several parts to remove them in one change. You cannot remove every part at once.
The readout
The seam runs under the stage. After the drawer's tabs, it shows, from left to right:
- What is under the pointer: a pad (
U1.1 · GND), a part (J1 · PZ254V-11-02P · HDR-1x2) or copper (+3V3 · B.Cu · 0.25 mm). - What you can do with what is picked, dimmed. While you draw a track, how to finish it. With nothing picked, it points at Question and Cmd+K.
- At the far end, the pointer's position in millimetres while it is over the board, then the grid step and the copper layers. Click a layer to draw on it. While you draw a track, its length so far.
- Stock and sync, only when they want a look.
The board's size and layer count are the Board line in the inspector, such as 42 × 26 mm · 2 layers.
| Check | Shows |
|---|---|
| Stock | Short at the selected quantity. Hidden while every line is in stock. |
| Sync | Off when this page has lost the server. Hidden while it is live. |
The verdict is in the poll, and its checks lead the inspector. Click a check to open its findings. On a phone, the readout sits under the poll and scrolls sideways.
The scope
The Scope tab is an oscilloscope over the simulation. It plots voltage against time for every net the simulation traced.
- The picked net is the highlighted trace. Pick it on the board, in the net list or in the legend.
- Alt-click a legend chip to hide that trace.
- Hover to read every net's value at that moment.
- Click to set cursor A, and Shift-click to set cursor B. The legend shows Δt, its frequency and ΔV.
- Scroll zooms the time axis, drag pans, and double-click shows the whole run.
- Drag the bar above the tabs to make the region taller.
Zoomed out, each pixel column draws the lowest and highest sample it covers, so spikes stay visible.
A version with no simulation says so, and draws no trace. Simulation explains what is simulated, and when no simulation is written.
The data is sim.json, next to the version's board.json:
{"kind": "transient", "engine": "ngspice 44",
"t": [0, 1e-6, 2e-6],
"nets": {"VIN": [0, 4.9, 5.0], "+3V3": [0, 0.2, 1.1]},
"stimulus": [{"net": "VIN", "kind": "step", "v": 5.0}],
"unmodelled": ["U2"], "notes": [], "seconds": 0.8}tis in seconds, ascending. Every trace innetshas the same length.unmodellednames parts the simulation could not represent. The chain's Sim box shows them as warnings.
The chain
The Chain tab shows the build that made this board, as a row of boxes: Design, Resolve, Sim, Place, Route, Pour, Check, Fab and Price.
- Each box shows the stage's time and result, such as the parts resolved or the router used.
- Anything a stage could not do appears under its box, in the warning colour.
- Click a box to open that stage's findings. A stage that did not run is dimmed.
- Pour warns when ground had to be routed as tracks under the pour.
Three boxes have a button that runs their stage again:
| Button | Does | New version? |
|---|---|---|
| Simulate | Runs the simulation on this version's netlist, in seconds | No. It adds sim.json to this version. |
| Place again | Rebuilds with the next anneal seed | Yes |
| Route again | Keeps the parts and placement, and routes again under the current constraints | Yes |
Route again picks up what changed since the build, such as a track you drew, a new floor, or a part you flipped.
The rack
The rack sits above the boxes. Its nine knobs change how the board is built, not what is on it.
| Knob | Sets | Saved as |
|---|---|---|
| Router | Which router lays the copper first: Lightcycle (default) or the A* router | rules.router |
| Seed | The anneal seed. The same design, pins and seed give the same placement. | rules.seed |
| Pour | Ground poured as a plane, or routed as tracks | rules.pour |
| Precedent | Whether a similar corpus board may seed the anneal | rules.precedent |
| Mark | The maker's mark on the silkscreen, or none | rules.mark |
| Floor | The narrowest track any routed net may use, in mm | rules.min_track_mm |
| Sides | Whether the placer may use the back | board.sides |
| Layers | Two copper layers, or four: signal, a ground plane, signal, signal. SOLDERMASK_PLANES=gnd+power makes In2.Cu a power plane. | board.layers |
| Outline | Whether the board may grow to fit its parts | board.fixed |
Each knob is saved in the design's constraints a second after you turn it. Every later build uses it.
- A knob you have set shows a dot under its label.
- Until you rebuild, the stale bar counts the knobs you turned. Hover over it for what the next build will use, such as next build: the A* router, seed 3, no pour.
- Place again raises Seed by one and rebuilds. Each version records the seed it was built with.
Variations are saved sets of knobs:
- + save stores the knobs as they are now, under a name.
- Click a chip to apply its set to the next build. Knobs the set does not include are cleared. Pins and your tracks are untouched.
- The chip that matches the current knobs is lit. Double-click a chip to rename it, and click × to delete it.
The address
The address bar carries where you are. Copy it to share exactly what you see.
/p/mcp-esp32/v004/cu?pick=J1&drawer=chain&findings=route
| Part | Values |
|---|---|
| Path | /p/<board>/<version>/<view>. The view is cu, 3d or sch. |
pick | A reference designator, net:GND, or finding:3 for the third finding |
drawer | chain, scope or cost, and on a phone findings. Leave it out and the drawer is shut. |
findings | The group open in the findings, such as route, or all. Leave it out and they are shut. |
- Each move to a new place is a step in the browser's history: a view, a pick, a version, a drawer tab or the findings.
- Moving between groups of findings is not a step, so Back closes them.
- Back and Forward walk those steps. Going back to another version opens it, as picking it in the version menu does.
- A pan, a zoom or a hover is not a step. Neither is a move another device makes through sync.
- A part or a net this version does not have is let go of.
/p/<board>opens the newest version and keeps the rest of the address.
Versions
The version chip in the header opens the version menu. It lists every version, newest first, with its verdict light, label, prompt and cost.
- Click a version to open it. Your next message edits it.
- Click its chevron to see what it changed, take its files, label it, add notes or fork it.
- Import a file, at the foot of the menu, builds a
design.jsonor reads a.kicad_pcbas the next version. - Esc shuts the menu.
See Versions and history.