Magia — Project Instructions

Worktree Development

When running the dev server, ALWAYS use pnpm dev:worktree instead of pnpm tauri:dev
dev:worktree auto-detects a free port and isolates app data per worktree
tauri:dev is only for quick single-worktree use with hardcoded port 5173
When setting up a new worktree: run pnpm install before anything else
Never hardcode port 5173 — use the MAGIA_DEV_PORT env var pattern

Feature flags are a local developer tool for toggling WIP features — see docs/feature-flags.md
Gated by developerMode — flags have no effect when Developer Mode is off
Register flags in FEATURE_FLAG_REGISTRY (src/lib/feature-flags.ts), they auto-appear in Settings UI