RompMusicClient app setup
The RompMusic client runs on Android, iOS, and web. You can use the official web app and set your server URL in the app, or host the web client yourself and optionally preconfigure the server URL at build time. The app includes per-user playlists: create playlists, add tracks from the library or from track/album menus, reorder and remove tracks, and play a playlist from the Playlists screen.
Using the web app
Use rompmusic.com/app. It uses the demo server by default. To use your own server: open Settings, then Server URL, enter your server address (e.g. https://music.yourdomain.com), and save. You will be logged out and can then sign in to your server.
First run (Android and iOS)
When you install the app from the Play Store or App Store (or build it without a preconfigured URL), the first time you open the app you see a Connect to your server screen. Enter the full URL of your RompMusic server (e.g. https://music.yourdomain.com) and tap Continue. The URL is saved; you can then log in with your admin or invited user account. If your server is not set up yet, see the Self-Hosting Guide.
Changing the server URL later
In the app: Settings then Server URL. Tap the row, enter the new URL, and save. Changing the server URL clears your session; you will need to log in again to the new server.
Hosting the web client yourself
You can build and serve the Expo web client from your own domain. The client repo has a Dockerfile that builds the web export and serves it with nginx. Set EXPO_PUBLIC_API_URL to your API base URL (e.g. https://music.yourdomain.com/api/v1) to preconfigure the server so users are not prompted; otherwise they see the server setup screen on first run. If you serve the client at a subpath (e.g. /app), set EXPO_PUBLIC_WEB_BASE_URL to that path so asset URLs and navigation work. See .env.example in the client repo for both variables.
Logging in
After the server URL is set, use the credentials from your server admin. The first user is created with the create_admin script on the server; see the Self-Hosting Guide. Additional users can be invited from the admin dashboard.