Skip to content

shellbear/yail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

324c9c3 Β· Jul 18, 2021

History

24 Commits
May 26, 2021
May 27, 2021
May 26, 2021
Jul 18, 2021
May 3, 2021
May 17, 2021
May 5, 2021
May 5, 2021
May 3, 2021
May 26, 2021
May 17, 2021
May 3, 2021
May 25, 2021
May 23, 2021
May 20, 2021
May 20, 2021
May 23, 2021

Repository files navigation

Yail

A real-time collaborative song-request queue for Spotify.

🎧 Demo

You can access the live demo at: https://yail.herokuapp.com/

preview

βš™οΈ Environment variables

You have to create a Spotify app. You can refer to the official documentation to create in a minute.

After created your app, you must first define the following environment variables:

  • SPOTIFY_CLIENT_ID
  • SPOTIFY_CLIENT_SECRET

You can put them inside a .env file at the root of the project or by manually exporting them.

🐳 Using Docker

docker build yail:latest .
docker run yail

πŸš€ Self-hosting

You can easily self-host this app. The easiest version is to run the app with Docker.

You have to define the following mandatory environment variables.

  • SECRET_KEY_BASE (64 bytes)

A secret used to encode session and other sensitive data. For security reasons it must be composed of at least 64 characters.

You can easily generate it inside the root of this repo using the mix phx.gen.secret command:

mix phx.gen.secret 64
  • BASE_URL

The base URL of the web application. This is for example the URL of a custom domain: https://example.com or an ip address.

πŸ§‘β€πŸ’» Get started

To start your Phoenix server:

  • Install dependencies with mix deps.get
  • Install Node.js dependencies with npm install inside the assets directory
  • Start Phoenix endpoint with mix phx.server

Now you can visit localhost:4000 from your browser.

πŸ— Built with

πŸ“§ Contributing

All contributions are welcome. Code must be formatted with hex format.