Festival

Festival is a web app to host online music festivals. It plays the same audio file for all users at the same time based on their system clock, allowing for the social aspect of a live broadcast (everyone can react to the same music at the same time) without requiring live streaming infrastructure.

Local Development

Copy .env.sample to .env and fill out the required values.
Run docker compose up -d to start a MySQL database.
Run npm install to install the required packages.
Run npm run dev to serve the application locally.

Azure Setup

Make sure that your Azure storage account is set to allow CORS requests. This is required for the visualizer to work.

Testing

npm run test will run the end-to-end tests.
npm run test-ct will run the component tests.

Building

npm run build will bundle the application for production.
npm start will serve the bundled application.

Deploying

Pushing to main triggers a deploy on Railway.

External Dependencies

Azure for file storage
Clerk for authentication
DigitalOcean for database hosting, DNS, and proxying to Railway
Railway for hosting
Sentry for error reporting