Open-source electronics design for people and AI agents.
Draw schematics, edit PCB layouts and work alongside an agent in the same editor,
with shared commands and undo history. Built in Rust for desktop and browser.
Quickstart · Documentation · Capabilities · Contributing · Vision
PCBCraft is in early development, with schematic and PCB editing on desktop and in the browser. You can draw a circuit, assign footprints, review changes before applying them to the board, place and edit copper tracks and through vias, and save the schematic and board together with shared undo/redo.
- Schematics: place and edit symbols, draw and reshape orthogonal wires, move or grab groups, mark unused pins and wire ends, name nets with local/global labels and power/ground symbols, and organize flat or hierarchical sheets.
- PCB layout: assign pinned footprints, review package and connection changes before applying them, draw a Board Outline, move/rotate/flip footprints, and place, move and resize tracks and through vias, and route around fixed copper. Layer controls, net highlighting and schematic/PCB component highlights help navigate the board; see the layout guide.
- Checks: review DRC findings for shorts, copper clearance, track width, via annular rings, unrouted connections, board edges and courtyard overlap, using saved board rules and supported dimensional net-class rules.
- Outputs: export supported board geometry as Gerber X2 copper, mask, paste, silkscreen and outline layers with aperture functions, plus net and pin attributes on copper. Circular plated holes are included as an Excellon drill file in the same archive.
- Views: work with schematic and PCB panes side by side, or use multiple desktop windows with independent cameras and a shared project session.
- Libraries: browse built-in, project-pinned and registered native libraries in Parts Library. Place generic or orderable parts, choose packages and assign footprints. Author symbols and footprints in their own workspaces, then publish revisions to writable native folders on desktop.
- Projects: save a Git-friendly project folder or share a
.pcarchive. Pinned symbol and footprint definitions travel with the project. The CLI can explicitly convert the previous split layout into a new copy. - AI tools: use the desktop Assistant with an installed agent or model endpoint, connect an MCP client to the open editor, or run a headless session.
Full ERC, broader DRC coverage, advanced routing, copper-zone fill and 3D/STEP workflows remain in development. Footprint slots, separate non-plated drill output and independent footprint mask/paste controls are not yet supported. The current checks and exporters do not establish manufacturing readiness.
The capability table separates available features from remaining work. The MVP milestone tracks the first collaboration-ready preview; VISION.md explains the longer-term direction, including familiar KiCad controls and links with SolidCraft.
Use Rust 1.95 or later. From the repository root, build the desktop app and its companion CLI, then launch the editor:
cargo build --locked -p pcbcraft -p pcbcraft-cli
cargo run --locked -p pcbcraftThe quickstart covers opening a project, schematic editing and saving, with PCB tools described in the editor guide. The sensor node example includes a small MCU, an I²C sensor, status LEDs and a routed board; a transistor flasher is available as a second demo. Both have shareable archives.
Run the browser app locally
Install the WebAssembly target and Trunk, then serve the app:
rustup target add wasm32-unknown-unknown
cargo install --locked trunk --version 0.21.14
cd apps/pcbcraft-web
trunk serve --lockedOpen localhost:8781. The browser uploads projects and
downloads .pc archives; the Assistant and live MCP connection are desktop features.
Build prerequisites and troubleshooting are in CONTRIBUTING.md.
Open Assistant beside Preferences in the desktop app to connect an installed coding agent or a compatible model endpoint. Edits run through the editor's commands, appear on the canvas and share its undo history.
For an external MCP client, choose Help (?) → Connect AI assistants… → Enable local connection and copy the configuration. For a separate headless session:
cargo run --locked -p pcbcraft-cli -- mcpNative live MCP also supports UI automation: locate named controls and send clicks, drags, keys, text and scrolling through ordinary editor input. Input currently targets the original native window and its split panes; headless sessions operate separately from the open editor.
The AI and MCP guide covers agent setup, permissions, live connections and command examples.
The documentation map groups user guides, implementation references, architecture plans and verification records, with reading paths for contributors and agents.
| Guide | Contents |
|---|---|
| Quickstart · Example project | First editing session |
| Editor guide | Tools, shortcuts, wiring, views and project files |
| Capabilities | Current support, limits and planned work |
| AI assistants and MCP · UI automation | Agent connections, shared commands and native UI input |
| Contributing · Agent instructions | Repository workflow, architecture and checks |
| Reference and formats | Project storage, library schemas, nets, rules and shared geometry |
CONTRIBUTING.md covers the build, code map, required checks
and source rules. Find a bounded task in
GitHub issues, check for
existing claims and open PRs, and leave a claimed comment on the issue
before starting. The first claimant gets merge priority under the
issue claim policy.
PCBCraft is an independent application in the Craft family. Development follows the clean-room contribution rules: published specifications and black-box observations are permitted; KiCad and other GPL EDA implementation sources are excluded.
MIT OR Apache-2.0, at your option. See LICENSE-MIT, LICENSE-APACHE and ATTRIBUTION.md for the project licenses and third-party notices. Library data, fonts and other assets retain their documented licenses.