| Guide | Description |
|---|---|
| Architecture | Module map, dependencies, playback and browsing layout |
| Getting started | Run the app from Xcode, Spotify Developer app setup, OAuth scopes |
| Building and testing | make, xcodebuild, local Release bundle |
| CI and releases | GitHub Actions workflow, Sparkle updates, artifacts, Gatekeeper |
| Appcast feed | Sparkle update RSS (GitHub Pages; updated by release workflow) |
| Data storage | Keychain, cache paths, settings.json |
| Pinning | Sidebar pins, wiggle mode, palette ⌘↩, storage |
| Limitations | Premium requirement, unsigned builds, operational constraints |
| Development roadmap | Where roadmap and shipped-milestone tracking live |