Add CMake scripts

Author: olilarkin

.claude/skills/build-cmake/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: build-cmake
+description: Build an iPlug2 plugin project using CMake (Ninja or Xcode generator)
+---
+
+# Build iPlug2 Plugin with CMake
+
+Use this skill when the user wants to build their plugin project using CMake.
+
+## Workflow
+
+1. **Identify the project:**
+   - Look for `CMakeLists.txt` in project directories
+   - If not specified, find projects excluding TemplateProject
+
+2. **Choose build method:**
+   - **Ninja** (fast, command-line): Best for quick iteration
+   - **Xcode** (IDE): Best for debugging
+
+## macOS Build with Ninja
+
+```bash
+# Configure (from repo root)
+cmake -B build -G Ninja -S [ProjectName]
+
+# Build specific target
+ninja -C build [ProjectName]-app
+ninja -C build [ProjectName]-vst3
+ninja -C build [ProjectName]-au
+ninja -C build [ProjectName]-clap
+```
+
+### Available Targets
+- `[ProjectName]-app` - Standalone application
+- `[ProjectName]-vst3` - VST3 plugin
+- `[ProjectName]-au` - Audio Unit (AUv2)
+- `[ProjectName]-clap` - CLAP plugin
+- `[ProjectName]AU-framework` - AUv3 framework
+- `[ProjectName]AUv3-appex` - AUv3 app extension
+
+### Graphics Backend and Renderer Selection
+
+Two options control the graphics system:
+- `IGRAPHICS_BACKEND`: `NANOVG` (default) or `SKIA`
+- `IGRAPHICS_RENDERER`: `METAL` (default), `GL2`, `GL3`, or `CPU`
+
+Valid combinations:
+- **NanoVG**: GL2, GL3, METAL
+- **Skia**: GL3, METAL, CPU
+
+```bash
+# NanoVG + Metal (default)
+cmake -B build -G Ninja -S [ProjectName]
+
+# NanoVG + OpenGL 3
+cmake -B build -G Ninja -S [ProjectName] -DIGRAPHICS_RENDERER=GL3
+
+# Skia + Metal (higher quality rendering)
+cmake -B build -G Ninja -S [ProjectName] -DIGRAPHICS_BACKEND=SKIA
+
+# Skia + CPU (software rendering, no GPU required)
+cmake -B build -G Ninja -S [ProjectName] -DIGRAPHICS_BACKEND=SKIA -DIGRAPHICS_RENDERER=CPU
+```
+
+**Note:** Skia requires prebuilt libraries. Run first:
+```bash
+./iPlug2/Dependencies/download-prebuilt-libs.sh mac
+```
+
+### Build Locations (symlinked)
+- APP: `~/Applications/[ProjectName].app`
+- VST3: `~/Library/Audio/Plug-Ins/VST3/`
+- AU: `~/Library/Audio/Plug-Ins/Components/`
+- CLAP: `~/Library/Audio/Plug-Ins/CLAP/`
+
+## macOS Build with Xcode Generator
+
+```bash
+# Generate Xcode project
+cmake -B build-xcode -G Xcode -S [ProjectName]
+
+# Open in Xcode
+open build-xcode/[ProjectName].xcodeproj
+```
+
+Or build from command line:
+```bash
+cmake --build build-xcode --target [ProjectName]-app --config Debug
+```
+
+## iOS Build
+
+```bash
+# Configure for iOS
+cmake -B build-ios -G Ninja -S [ProjectName] \
+  -DCMAKE_SYSTEM_NAME=iOS \
+  -DCMAKE_OSX_DEPLOYMENT_TARGET=15.0
+
+# Build iOS app with embedded AUv3
+ninja -C build-ios [ProjectName]-ios-app
+```
+
+### iOS Targets
+- `[ProjectName]-ios-app` - iOS standalone app
+- `[ProjectName]AU-ios-framework` - iOS AUv3 framework
+- `[ProjectName]AUv3-ios-appex` - iOS AUv3 app extension
+
+For running in Simulator, use the `run-ios-simulator` skill.
+
+## Web/WAM Build (Emscripten)
+
+```bash
+# Configure with Emscripten
+emcmake cmake -B build-web -G Ninja -S [ProjectName]
+
+# Build WAM targets
+ninja -C build-web [ProjectName]-wam
+ninja -C build-web [ProjectName]-web
+
+# Create distribution
+ninja -C build-web [ProjectName]-wam-dist
+```
+
+Output in `build-web/out/[ProjectName]-wam/`
+
+## Clean Build
+
+```bash
+# Remove build directory and reconfigure
+rm -rf build && cmake -B build -G Ninja -S [ProjectName]
+```
+
+## Tips
+
+- Use `ninja -C build` without target to build everything
+- Add `-j4` to limit parallel jobs if needed
+- Check `CMakeCache.txt` in build dir to verify settings
+- Use `ccmake -B build` for interactive configuration
+
+## Example
+
+```bash
+# Quick build of standalone app
+cmake -B build -G Ninja -S MySynth
+ninja -C build MySynth-app
+
+# Open the built app
+open ~/Applications/MySynth.app
+
+# Rebuild with Skia backend
+rm -rf build
+cmake -B build -G Ninja -S MySynth -DIGRAPHICS_BACKEND=SKIA
+ninja -C build MySynth-app
+```