Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tvillarete/apple-music-js
A music streaming service built from the ground up using React & Redux
https://github.com/tvillarete/apple-music-js
Last synced: 27 days ago
JSON representation
A music streaming service built from the ground up using React & Redux
- Host: GitHub
- URL: https://github.com/tvillarete/apple-music-js
- Owner: tvillarete
- License: mit
- Created: 2018-07-08T17:27:59.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-03T15:19:03.000Z (almost 2 years ago)
- Last Synced: 2024-10-01T11:21:43.056Z (about 1 month ago)
- Language: JavaScript
- Homepage: http://tannerv.com/music
- Size: 1.76 MB
- Stars: 1,827
- Watchers: 32
- Forks: 196
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
Built by **Tanner Villarete**
Connect with me on [LinkedIn](https://linkedin.com/in/tvillarete)! I'll be graduating soon ;)
# How far can JavaScript take us?
Turns out, pretty dang far. This web app was my attempt at mimicking Apple's iOS music app, and I think I've come pretty close!
Check out a live demo [here](http://tannerv.com/music)
---
---
---
I'm in my fourth year of college, and it's been super cool to see how much I've improved and continue to improve all aspects of programming.
## Backend API
The API is hosted on a Raspberry Pi, and it's kept private (but still accessible if you try) so that it doesn't get overloaded. If you're interested in building your own backend to plug into this tool, here's what my database and endpoints look like:
### Database
There are six required columns:
- `name`: The name of the song
- `artist`: The artist name
- `album`: The album name
- `track`: The index of the song relative to the album (To order songs in an album)
- `url`: A URL to the audio file
- `artwork`: A URL to the album artwork image
```mysql
mysql> use music;
Database changed
mysql> desc tracks;
+------------+------------------+------+-----+---------+----------------+
| Field | Type | Null | Key | Default | Extra |
+------------+------------------+------+-----+---------+----------------+
| id | int(10) unsigned | NO | PRI | NULL | auto_increment |
| created_at | timestamp | YES | | NULL | |
| updated_at | timestamp | YES | | NULL | |
| name | varchar(255) | NO | | NULL | |
| artist | varchar(255) | NO | | NULL | |
| album | varchar(255) | NO | | NULL | |
| track | int(11) | NO | | NULL | |
| url | varchar(255) | NO | | NULL | |
| artwork | varchar(255) | NO | | NULL | |
+------------+------------------+------+-----+---------+----------------+
9 rows in set (0.05 sec)
```
### API Endpoints
The backend is built with PHP using the Laravel ORM. I only needed a few API endpoints to get this working:
- `/albums` - Returns a list of all album names with their corresponding artist
- `/album/{album}` - Returns a list of songs from a specified album
- `/artists` - Returns a list of all artists
- `/artist/{artist}` - Returns a list of all albums from a specific artist
Feel free to reach out if you have questions!
## Local Development
To run this app locally, clone the project (or download it as a zip and unzip it to a directory), navigate to the root directory with a command prompt or terminal (where the package.json file is located), and run npm install to download the necessary dependencies onto your local machine.
Inside the root directory, you can run some built-in commands:
```
npm start
```
Runs the app in development mode.
Open http://localhost:3000 to view it in the browser.
The page will automatically reload if you make changes to the code.
You will see the build errors and lint warnings in the console.
```
npm run build
```
Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed.