Getting Started

Use this guide to install pcb, create a board repository, validate its Zener source, and generate a KiCad layout.

Requirements

macOS or Linux. Windows support is experimental; use WSL2 for the most stable Windows environment.
Git, which pcb new board uses to initialize a repository.
KiCad 10.x for layout generation and editing. pcb build does not require KiCad.

1. Install `pcb`

Run the installer for your platform:

curl -fsSL https://raw.githubusercontent.com/diodeinc/pcb/main/install.sh | bash

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/diodeinc/pcb/main/install.ps1 | iex"

Default install directories are $HOME/.local/bin on Unix and %USERPROFILE%\.pcb\bin on Windows; override with PCB_INSTALL_DIR. The installer adds pcb to your user PATH when necessary. Verify installation:

pcb --version

For source builds, see the repository README.

2. Create a board repository

Replace the example repository URL with the project repository URL:

pcb new board Blinky github.com/your-org/blinky
cd Blinky

The generated design is empty but valid. See Packages for repository structure.

3. Build the board

Validate the board source and generate its netlist:

pcb build Blinky.zen

4. Generate the layout

Generate the KiCad files without opening KiCad:

pcb layout --no-open Blinky.zen

This command writes the generated board under layout/.

Toolchains

pcb manages the compiler, stdlib, and sidecars as one toolchain. Workspace commands use pcb-version; pcb auth uses latest stable instead. An explicit pcb +<version> <command> overrides either selection.

pcb toolchain show              # Active and available versions; --offline avoids network
pcb toolchain install latest    # Also accepts nightly, a lane (0.4), or an exact version
pcb toolchain repair latest     # Validate and restore a toolchain
pcb toolchain prune --dry-run   # Preview cleanup; omit --dry-run to remove files
pcb self update                # Update the shim and managed channels

Pruning removes downloads and superseded patches, preserving the newest patch per lane, the active version, prereleases, nightly, and local toolchains.

Service accounts and CI

Run pcb auth login --service-account interactively, or import JSON containing client_id and client_secret:

pcb auth login --service-account --stdin < credentials.json

For CI, supply DIODE_API_URL, DIODE_CLIENT_ID, and DIODE_CLIENT_SECRET through the CI secret store. PCB renews access tokens automatically.

Troubleshooting

If the shell cannot find pcb after installation, restart the shell or source the environment file printed by the installer.
If pcb layout cannot find KiCad, install kicad-cli and pcbnew. Set KICAD_CLI or KICAD_PCBNEW if either executable is outside its default platform path.
Installers register diode:// links for opening registry layouts in KiCad. If opening fails, check ~/.pcb/pcb-launcher.log (Windows: %USERPROFILE%\.pcb\pcb-launcher.log). ./install.sh --local registers the local toolchain; release installation or pcb self update restores latest.
Run pcb help or pcb help <command> for the complete CLI reference.

Toolchain

Registry

Examples

Requirements

1. Install `pcb`

2. Create a board repository

3. Build the board

4. Generate the layout

Toolchains

Service accounts and CI

Troubleshooting

​Requirements

​1. Install pcb

​2. Create a board repository

​3. Build the board

​4. Generate the layout

​Toolchains

​Service accounts and CI

​Troubleshooting

Requirements

1. Install `pcb`

2. Create a board repository

3. Build the board

4. Generate the layout

Toolchains

Service accounts and CI

Troubleshooting