iOS client for Nightwave Plaza, a 24/7 vaporwave radio.
The UI is a web app (a mobile build of the plaza.one interface) shown in a WKWebView. Everything else is native: audio playback, lock screen controls, metadata, video backgrounds.
- Xcode 27.1 or newer
jqfor the fetch script (brew install jq)
- Download the latest web UI bundle:
./Scripts/fetch_view.sh
Use ./Scripts/fetch_view.sh dev if you want the dev snapshot instead.
- Create
AppConfig.xcconfigin the project root (this file is not in git):
SENTRY_DSN =
Leave the value empty if you don't need Sentry.
- Open
NightwavePlaza.xcodeprojand build. Dependencies (Sentry, Swifter) are resolved by Swift Package Manager on first build.
Scripts/fetch_view.shdownloads the pre-built web UI intoNightwavePlaza/WebApp. This folder is not stored in git.- On launch the app starts a local server on
127.0.0.1:8080and loads it in a WKWebView. - The web UI talks to the native side through a JS bridge: playback control, backgrounds, sleep timer, theme color and language.
- Song metadata comes from ID3 tags in the HLS stream, then the app fetches song details from the Plaza API for the lock screen.
- Comment only non-obvious logic — do not comment self-explanatory code.
- Write brief, plain English comments without flowery language.
- Start comments with a capital letter and omit trailing periods.
- Describe the code as it is now (e.g.,
// Done this way because...), never the editing history or diff (// Changed A to B...).