Skip to content

dctalbot/spinitron-mobile-app

Repository files navigation

spinitron-mobile-app

Get it on Google Play Download on the App Store

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.

Prerequisites

  1. A spinitron-proxy deployment. This serves as a relay between the app and the Spinitron API.
  2. An Expo account for building the app distributions.
  3. A Google Play Developer account for Android.
  4. An Apple Developer account for iOS.
  5. The Expo CLI:
npm install -g eas-cli
npm install -g expo-cli

Getting Started

  1. Fork this repository.
  2. 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)

Android

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

iOS

  1. Create a new app project in the Apple Developer Console.
  2. Set "runtimeVersion": "exposdk:52.0.17", in app.json (?)
  3. Run eas build -p ios
  4. Download the build from Expo
  5. Upload the build to Apple

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.

As a service

If you want the app but all of this feels overwhelming, you can pay me to take care of it. Email [email protected] and we can set up some time to chat about your needs. This service includes:

  • ✅ A hosted relay server
  • ✅ Basic branding and customization
  • ✅ App store presence (screenshots, icons, descriptions, etc.)
  • ✅ Regular updates and maintenance
  • ✅ Mentorship hours for students and support hours for general staff
  • ✅ Help sustain the development of this project

Related Projects

Contributing

See CONTRIBUTING.md.