Support

TurboPCB 1.0 for macOS 26 and later

Found a bug, or want a part added to the library? Get in touch through the Desirable Apps contact page. Project files are plain JSON and contain nothing but your design, so attaching one is safe.

Getting started

Draw. Click a part in the sidebar to place it, press W to draw wires between pins, R to rotate, and double-click a part to rename it or change its value. Tidy Schematic in the Layout menu arranges the sheet.
Lay out. Choose Layout › Auto Layout. The board view shows the parts placed and the copper routed. Drag anything you want elsewhere and press Auto Route again.
Export. From the File menu or the share button, choose G-code for the Makera Carvera or GRBL, SVG layers for other desktop CNC software, or Gerber + Drill when you want a board house to make the board. A parts list and assembly sheet PDF go out with every export.

Board settings and design rules

The inspector on the right sets the board size, thickness, trace width, clearance and edge clearance. The defaults suit a 0.1 to 0.2 mm V-bit on a desktop CNC. Commercial fabs allow 0.15 mm traces, so you can tighten the rules for a smaller board. If the layout uses only part of the board, the banner above it offers Shrink to Fit.

Wire links

On a single-sided board some connections cannot be routed in copper. Instead of failing, the router adds a wire link: two extra holes with an orange arc between them. Solder a piece of bare wire between those holes on the component side. The assembly sheet lists every link as W1, W2 and so on.

AI Designer

The AI Designer has two options, chosen from the menu at the top of its window.

Apple Intelligence runs on your Mac, is free, and sends nothing anywhere. It handles parts from a description. This needs an Apple silicon Mac with Apple Intelligence turned on in System Settings.
Claude handles whole circuits and explains the design. It needs a Claude API key, which means a paid account with Anthropic that is separate from TurboPCB. Anthropic bills that account for what you use; a typical circuit costs a few cents.
Web Download reads a parts list from a project web page. Paste the address and say what you want done with it.

Setting up a Claude API key

Create an account at the Claude Console. A claude.ai chat subscription does not include API access; the Console account is billed separately, by prepaid credits, so add a small amount of credit under Billing.
Open the API Keys page and create a key. Copy it straight away; the Console will not show it again. Anthropic's own guide is Get your Claude API key.
In TurboPCB choose TurboPCB › Settings › AI and paste the key. It is stored in your macOS login Keychain and is only ever sent to api.anthropic.com.
Open the AI Designer, choose Claude (your API key) at the top, and describe a circuit.

Printing

⌘P prints whatever the window is showing: the schematic, the board or the parts list. The print panel's PDF button saves the same page as a file. The first time you print, macOS may ask whether TurboPCB can look for printers on your local network; that is for AirPrint discovery and the app receives nothing from it.

Opening exports elsewhere

Board houses. Zip the Gerber and drill files together and upload the zip. JLCPCB and PCBWay both accept them. Order a 1-layer board.
Snapmaker Luban, Carbide Create, LightBurn. Import the SVG copper layer for isolation, the drill layer for holes and the outline for the cut-out. All three share the same origin.
Makera Carvera. Load the G-code in Carvera Controller. The file includes the tool changes, probing and grid levelling.

Frequently asked

The router left a connection unrouted. Enlarge the board a little or loosen the clearance, then run Auto Route again. Moving the crowded part by hand usually helps too.
I want a part that is not in the library. Ask for it through the contact page below, naming the part and its footprint, and it will be added to the library. Custom footprints are coming in a later release.
Where are my files? Wherever you saved them. TurboPCB documents are ordinary files with the extension .turbopcb; the app has no library or cloud of its own.

Contact

TurboPCB is made by Desirable Apps. Use the Desirable Apps contact page for questions, bug reports and part requests. Include the macOS version and, for layout questions, the project file.