Watch

Self-hosted emergence-engineering/pcbjam (browser KiCad WASM) — CMMS embed fork. Upstream tracked as remote "upstream".

TypeScript 49.1%
C++ 36%
Shell 4.2%
C 2.9%
JavaScript 2.6%
Other 5.2%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Viktor Vaczi a0a6023400 Fix Docker build caching with checksum-based rsync Replace timestamp-based rsync + touch with checksum-based sync: - Use --checksum to only transfer files with actual content changes - Remove touch mechanism that caused all files to appear "newer" - Exclude .git, logs, .idea, node_modules from sync The old approach created a perpetual timestamp mismatch: 1. rsync -a preserved host timestamps 2. touch set container timestamps 3. Next build saw mismatch → transferred everything → touched again With --checksum mode: - Changed files: transferred with current time → rebuilt (correct) - Unchanged files: not transferred → keep timestamp → no rebuild (correct) Tested scenarios: - Consecutive builds: ~2 min (cached) vs ~6+ min (was full rebuild) - Modified wxWidgets file: only that file recompiled - Modified KiCad file: only that file recompiled 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>		2026-01-05 10:20:08 +01:00
docker	Fix Docker build caching with checksum-based rsync	2026-01-05 10:20:08 +01:00
docs/research	Add research doc: OpenGL, GAL, and WebGL strategy	2026-01-02 10:40:03 +01:00
kicad@a61d2ea406	Enable OpenGL GAL and 3D viewer stubs for WASM	2026-01-03 08:19:40 +01:00
logs	Added logs .gitignore.	2026-01-03 13:52:34 +01:00
scripts	Restore elementtracker.h and add build logging	2026-01-03 11:55:54 +01:00
tests	Clean up test infrastructure and fix test assertions	2026-01-01 20:18:19 +01:00
wasm	Add missing GLU_TESS_BOUNDARY_ONLY constant for idftools	2026-01-03 11:24:24 +01:00
wxwidgets@4c8ef179b8	Restore elementtracker.h and add build logging	2026-01-03 11:55:54 +01:00
.dockerignore	Add Docker build environment for KiCad WASM	2025-12-08 12:07:01 +01:00
.gitignore	Add runtime resource loading and fix Docker incremental builds	2025-12-27 20:09:26 +01:00
.gitmodules	Remove unused legacy build scripts and directories	2025-12-27 11:07:54 +01:00
build.md	Update documentation to reflect current project structure	2025-12-27 11:13:17 +01:00
CLAUDE.md	Add KiCad WASM build infrastructure and dependency scripts	2025-12-04 13:15:04 +01:00
README.md	Add Quick Start docs and branch-specific Docker builds	2026-01-03 09:08:12 +01:00

README.md

KiCad WebAssembly Port

Run KiCad PCBnew in the browser using WebAssembly.

Quick Start

Full Build (KiCad + All Tests)

# 1. Initialize submodules
git submodule update --init --recursive

# 2. Build KiCad WASM (Docker, ~10 min incremental, ~1-2 hours full)
./docker/build.sh

# 3. Build wxWidgets for local testing
./scripts/build-wxuniversal-wasm.sh

# 4. Build wxWidgets test apps
./scripts/build-wasm-test.sh

# 5. Run all tests
cd tests && npm install
npm test              # wxWidgets tests (256 tests)
npm run test:kicad    # KiCad tests (2 tests)

wxWidgets Only (No Docker)

# Requires: Emscripten SDK 4.0+, Node.js 18+
./scripts/build-wxuniversal-wasm.sh
./scripts/build-wasm-test.sh
cd tests && npm install && npm test

Project Structure

kicad-wasm/
├── kicad/                  # KiCad source (git submodule)
├── wxwidgets/              # wxWidgets source (git submodule)
├── wasm/                   # WASM compatibility layer
│   ├── bindings/           # Embind bindings for JavaScript
│   ├── cmake/              # CMake find modules
│   ├── kiplatform/         # Platform abstraction (app, UI, printing)
│   ├── libcontext/         # Coroutine/fiber implementation
│   ├── shims/              # Runtime JavaScript shims
│   └── stubs/              # Stub implementations (libgit2, curl)
├── scripts/                # Build scripts
│   ├── build-wxuniversal-wasm.sh   # Build wxWidgets for WASM
│   ├── build-wasm-test.sh          # Build wxWidgets test apps
│   ├── deps/               # Dependency build scripts
│   ├── kicad/              # KiCad build scripts
│   ├── common/             # Shared utilities
│   └── config/             # Build config wrappers
├── docker/                 # Docker build environment
├── tests/                  # Playwright E2E tests
│   ├── e2e/                # Test specs
│   └── apps/               # WASM test applications
├── tools/                  # External tools (binaryen)
└── output/                 # Build output (pcbnew.js, pcbnew.wasm)

Two Build Workflows

1. KiCad Build (Docker)

Full KiCad PCBnew build using Docker:

# Build KiCad WASM
./docker/build.sh

# Copy output to test directory
./tests/scripts/setup-kicad-wasm.sh

# Run KiCad tests
cd tests && npm install && npm run test:kicad

Output: output/pcbnew.js, output/pcbnew.wasm

See build.md for detailed build documentation.

2. wxWidgets Test Apps (Local)

Build standalone wxWidgets test apps for feature testing:

# Build wxWidgets for WASM
./scripts/build-wxuniversal-wasm.sh

# Build test apps
./scripts/build-wasm-test.sh

# Run wxWidgets tests
cd tests && npm install && npm test

Output: tests/apps/standalone/

Prerequisites

For KiCad Build (Docker)

Docker Desktop with 16GB+ RAM allocated
10+ GB disk space for build cache

For wxWidgets Build (Local)

Emscripten SDK 4.0+
Node.js 18+ (for tests)

# macOS
brew install emscripten node

# Initialize submodules
git submodule update --init --recursive

Testing

cd tests
npm install

# Run all tests
npm test

# Run specific tests
npm run test:kicad          # KiCad tests only
npx playwright test menu    # Menu tests only

See tests/README.md for test documentation.

Current Status

wxWidgets WASM: Core widgets working (menus, dialogs, grids, trees, OpenGL)
KiCad PCBnew: Builds and loads in browser, canvas rendering working
In Progress: Testing wxWidgets features used by KiCad

Documentation

Build System - Docker build details
Docker README - Container setup
Tests README - Test infrastructure

License

KiCad is GPL-3.0. This project follows the same license.