Music Sampler

This is a web app that delivers short 30 second soundtracks to users through the use of Spotify's API. Users can search for an artist and retrieve the top 10 tracks for that artist. Server to server authentication allows the user free use of the search API without providing client information. An access token is received from every initial POST request made to Spotify on startup. Tokens expire after an hour of use.

Table of Contents

• Demo
• Implementation
• Deployment
• Technologies
• License

Demo

The app is currently live: https://ms-zm.herokuapp.com/

Implementation

To clone this repository you need Git, Node and Node's package manager (npm) installed on your computer.

Dependencies

"dependencies": {
    "axios": "^0.18.0",
    "express": "^4.16.3",
    "node-sass-chokidar": "^1.3.0",
    "npm-run-all": "^4.1.3",
    "react": "^16.3.2",
    "react-dom": "^16.3.2",
    "react-scripts": "1.1.4"
},
"devDependencies": {
    "cors": "^2.8.4",
    "nodemon": "^1.17.4"
}

Installation

# clone the repo
$ git clone https://github.com/Ziwam/music-sampler.git

# go into the repo
$ cd music-sampler

# install the dependencies
$ npm install

# start the app
$ npm run start-css

Deployment

Create a development-ready build be running.

$ npm run build

A folder called build will appear in the root of the project. If you wish to change to name of the folder, don't forget to change the path in the server.js file to the appropriate life name.

Technologies

This project includes:

• React
• Spotify API
• Node.js
• Express
• Sass

License

(MIT License) The MIT License (MIT) Copyright (c) 2018 Ziwa Mukungu zmukungu@gmail.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.