mixboard/.github/copilot-instructions.md

Copilot Instructions — MixBoard

Last updated: 2026-03-13

---

Workspace Overview

MixBoard is a macOS native music player built with Swift 5.9 and SwiftUI, targeting macOS 14+ (Sonoma).

Key Features

• Audio playback via AVAudioEngine with 3-band EQ
• BPM and key detection
• Waveform visualization
• 14 retro skins
• DAW export (Audition, Bitwig, REAPER, etc.)
• Cue points, playlists with folders
• Lyrics fetching from LRCLIB
• SwiftData for persistence

Active Integration: Chad Music

Cloud music integration with Chad Music — a self-hosted Common Lisp music server. See .orchestra/knowledge.md for architecture decisions and full spec at Work vault .orchestra/mixboard-chadmusic/spec.md.

Tech Stack

• Language: Swift 5.9
• UI: SwiftUI
• Platform: macOS 14+ (Sonoma)
• Data: SwiftData
• Audio: AVAudioEngine (local), AVPlayer (cloud streaming)
• Build: Xcode / xcodegen (project.yml)

Conventions

• Source code in Sources/
• Tests in Tests/
• Project config in project.yml (xcodegen) and Package.swift
• Build instructions in INSTRUCTIONS.md

Orchestra

Multi-model deliberation engine is active. Config at .orchestra/config.json, knowledge at .orchestra/knowledge.md. No domain pack — general mode.