Add Quick Start docs and branch-specific Docker builds

- README.md: Add Quick Start section with full build sequence
- docker/README.md: Document branch-specific builds with git worktrees
- docker/build.sh: Use branch name for COMPOSE_PROJECT_NAME
- docker/docker-compose.yml: Remove hardcoded container_name

Each branch now gets isolated Docker containers/volumes, enabling
parallel development across git worktrees.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Viktor Vaczi 2026-01-03 07:31:46 +01:00
commit 2b96d4ba21
4 changed files with 65 additions and 1 deletions

View file

@ -21,6 +21,33 @@ This directory contains Docker configuration for building KiCad for WebAssembly
./docker/shell.sh
```
## Branch-Specific Builds
Each git branch gets isolated Docker containers and volumes, enabling parallel development:
```bash
# On branch 'main' → containers/volumes prefixed with 'kicad-wasm-main'
# On branch 'feature-x' → containers/volumes prefixed with 'kicad-wasm-feature-x'
```
This allows you to:
- Work on multiple branches simultaneously using git worktrees
- Each worktree has its own build cache (no conflicts)
- Switch branches without rebuilding from scratch
**Using git worktrees for parallel development:**
```bash
# Create a worktree for a new branch
git worktree add ../kicad-wasm-feature path/to/branch
# Build in the worktree (uses isolated Docker volumes)
cd ../kicad-wasm-feature
./docker/build.sh
# List all worktrees
git worktree list
```
## What Gets Built
The build process includes: