dctalbot / spinitron-mobile-app

Customizable Spinitron mobile app

spinitron-mobile-app

new.MP4

This is a cross-platform mobile app (for iOS and Android) that I wrote for WCBN, the college station where I used to DJ, but any station backed by Spinitron can take it "off the shelf" and have it deployed with minimal effort.

Getting Started

1. Deploy a relay server to proxy requests to the Spinitron API. For example: https://github.com/wcbn/spinitron-proxy
2. Create an Expo account. They will build the app for you.
3. Fork this repository.
4. On the fork, update the following files to have the app match your brand:

• app.config.ts (settings and options)
• src/theme/theme.ts (look and feel)
• assets/* (brand images)

5. Install the Expo CLI: npm install -g expo-cli

Android

1. Create a Google Play Developer account and create a new android project.
2. Run eas build -p android
3. Download the build from Expo
4. Upload the build to Google Play

It's deployed... what now?

The maintenance burden mostly consists of keeping your fork up to date with any bug fixes that I commit to this repository. The expected release cadence is about once every 6 months.

Related Projects

• https://github.com/wcbn/spinitron-proxy/
• https://github.com/dctalbot/react-spinitron
• https://github.com/spinitron/v2api

Contributing

Please run make check and fix any errors before opening a pull request.

Requirements

• Node version specified in .nvmrc
• Create an Expo account and download the app https://expo.dev/client

brew install watchman
npm install -g expo-cli
npm install

Local environment setup

• You may need to change the eas.projectId in app.config.ts to match the project you have set up in your account.
• Run make build-dev
• When it is ready, download the build on your phone and install it.
• Run make start