https://github.com/carissaallen/music-app

Generates a playlist recommendation based on a seed value.
https://github.com/carissaallen/music-app

css3 express html5 javascript jquery nodejs spotify-api

Last synced: 29 days ago
JSON representation

Generates a playlist recommendation based on a seed value.

• Host: GitHub
• URL: https://github.com/carissaallen/music-app
• Owner: carissaallen
• Created: 2019-04-16T00:01:14.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2019-06-05T22:33:54.000Z (over 5 years ago)
• Last Synced: 2024-10-31T02:23:21.130Z (3 months ago)
• Topics: css3, express, html5, javascript, jquery, nodejs, spotify-api
• Language: HTML
• Homepage: https://musicdiscovery-hc.herokuapp.com/
• Size: 31.2 MB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Discover new music you'll enjoy.

Generates a playlist recommendation based on a user's favorite artist or song.

## Built With

| Frontend  | Backend |

| ------------- | ------------- |

| HTML5  | Node.js  |

| CSS3  | Express  |

| Bootstrap 4  | Mustache  |

| jQuery  | [Spotify API](https://developer.spotify.com/documentation/web-api/reference/browse/get-recommendations/)  |

## Dependencies

Used npm as our package manager to install the following:

`express`, `express-session`, `fs`, `mustache`, `querystring`, `request`, `spotify-web-api-node`, `node-sass`

**Heroku CLI**

Installed the [Heroku CLI](https://devcenter.heroku.com/articles/getting-started-with-nodejs#set-up) for deployment.

## Deployment

Deployed to: [https://musicdiscovery-hc.herokuapp.com/](https://musicdiscovery-hc.herokuapp.com/)

Continuous deployment is set up on the master branch.

## Configuration Variables

In order to connect the app with the Spotify API, follow Spotify's instructions to set up a Client ID, Client Secret and whitelist a Redirect URI: 

The configuration variables will need to be added to Heroku. Instructions for how to do that are available here: 

## Running the App Locally

If you wish to run the app locally, you will need to add a `.env` file to your working directory with the Client ID, Client Secret, and Redirect URI in it. You can modify `.env.sample` with the tokens you receive from Spotify. Once the `.env` file is created, you can run the app on your local host by typing the command `heroku local -p ` (e.g. `heroku local -p 3000`) in the terminal.

## Design Inspiration

[Magic Playlist](https://magicplaylist.co/)

## Acknowledgments

A big thanks to the incredible photographers who contributed to [Unsplash](https://unsplash.com/), which is where we were able to get some great content for our application.

Learned about Sass and animated text from Jason Arnold's [Getting started with Sass](https://medium.com/@thejasonfile/getting-started-with-sass-dedb271bdf5a), and used Robin Treur's [CodePen](https://codepen.io/RobinTreur/pen/pyWLeB) as the foundational code for the animated text on the saved playlist page. 

## Built By

* Hannah Galbraith

* Carissa Allen