Skip to content

Add a guide on placing components for autorouting, and document copperpour unbroken - #1047

Open
nitina-ariveguru wants to merge 1 commit into
tscircuit:mainfrom
nitina-ariveguru:docs/placing-components-for-autorouting
Open

nitina-ariveguru wants to merge 1 commit into
tscircuit:mainfrom
nitina-ariveguru:docs/placing-components-for-autorouting

Conversation

@nitina-ariveguru

@nitina-ariveguru nitina-ariveguru commented Nov 16, 2026 •

Copy link
Copy Markdown

Adds a short Essentials guide on placing parts so the autorouter produces clean boards, and documents the unbroken prop on <copperpour />, which wasn't in the docs.

Preview

New page: guides/tscircuit-essentials/placing-components-for-autorouting.mdx

  • A placement-first workflow: fixed parts → critical circuits → functional groups → route and check, going back to placement when a route is forced to be ugly.
  • Pointing connected pins at each other: a before/after pair of live previews. Two 4-pin headers with opposite pin order need 2 vias and about 18% more copper; matching the order gives four straight traces on one layer.
  • Placing decoupling capacitors and ground first, using an unbroken bottom pour.
  • When to move parts instead of rerouting, and the tsci check commands for reviewing a layout (placement, routing-difficulty, shorts, pcb-style).

It links to the existing groups guide, tsci check page and autorouter bug-report page rather than repeating them.

elements/copperpour.mdx

  • Adds unbroken to the properties table (description taken from the prop's own .describe() text).
  • Adds a "Keeping a Pour Unbroken" section with a live preview. With unbroken, U1's and C1's ground pads each get a via to the bottom pour and no signal crosses the bottom layer. Without it, the same board joins the ground pads with top-layer traces and uses no vias.

Testing

  • Built every example with tscircuit 0.0.3187 in codetestingplayground (test files removed afterwards). All build with no errors, and the via counts and layer usage described in the text match the built circuit.json.
  • Ran each tsci check command listed on the page against the ground-plane example.
  • docusaurus build passes.

These come from building a few small boards (a 555 blinker, an I2C sensor breakout, a flip-flop counter and a PWM dimmer), where nearly every routing problem was fixed by moving or rotating parts rather than by changing routing settings.

🤖 Generated with Claude Code

…pour unbroken

The new Essentials page covers a placement-first workflow, pointing connected
pins at each other (with a before/after preview), placing decoupling and ground
first, when to move parts instead of rerouting, and the tsci check commands.

copperpour.mdx gains the unbroken prop in its table and a section with a live
preview showing ground pads dropping to the pour through vias.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Nov 16, 2026 7:03am UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 2236c742 Deployed Nov 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant