v1.0.0-beta.3

SpinDeck v1.0.0-beta.3

First usable desktop pre-release. Fixes the post-install white screen and startup timeout issues present in beta.1 and beta.2.

Fixes

• Desktop startup failure — Fixed embedded Node server failing to start, which caused “Timed out waiting for port 17345”
• Missing runtime dependencies — Fixed nested packages (e.g. Express → body-parser) not being bundled after pnpm deploy
• White screen / SSR — Fixed React dual-instance conflict in the desktop runtime
• Startup crash — Server startup failures no longer panic the app; an error page is shown and details are written to logs
• macOS Node resolution — Improved detection of node from Homebrew, nvm, and other common installs

Requirements

• Node.js 20+ (the desktop app runs an embedded server using your system Node; Node is not bundled yet)
• macOS 12+ / Windows 10+ / mainstream Linux distributions

Installation (macOS)

1. Download the .dmg for your architecture (aarch64 for Apple Silicon, x64 for Intel)
2. Open the DMG and drag SpinDeck.app into Applications — do not run it directly from the mounted volume
3. If Gatekeeper blocks the app: right-click → Open → confirm Open again
4. If macOS reports the app as “damaged”: run xattr -cr /Applications/SpinDeck.app
5. Ensure Node.js is installed: node -v (must be ≥ 20)

Troubleshooting

Log directory:

• macOS: ~/Library/Logs/com.spindeck.app/
• Windows: %LOCALAPPDATA%\com.spindeck.app\logs\
• Linux: ~/.local/share/com.spindeck.app/logs/

Do not use

These releases have known white-screen issues:

• v1.0.0-beta.1
• v1.0.0-beta.2

Docs

• Desktop app guide

---

Full desktop player control is currently recommended on macOS only (Windows/Linux playback control remains limited).