Oud Front-End
Table of Contents
- About the Project
- Getting Started
- Screenshots
- Videos
- File Structure
- Unit Testing
- Functional Documentation
- Contributing
- Contributors
- License
About The Project
Oud is an online music streaming service which is a high quality clone of Spotify with all its functionalities
Build with
Getting Started
This is an list of needed instructions to set up your project locally, to get a local copy up and running follow these instructuins.
Installation
- Clone the repository
$ git clone https://github.com/AbdallahHemdan/oudFrontend.git
- Navigate to repository directory
$ cd oudFrontend
- Install dependencies
$ npm install
Running
- Running on development mode
$ npm run json:server
$ npm run dev
- Running on production mode
$ npm run prod
Screenshots
Videos
File Structure
Oud-Frontend
βββ README.md
βββ LICENSE
βββ CONTRIBUTING.md
βββ oudfrontend
βββ node_modules
βββ package.json
βββ jsdoc.conf.json
βββ .env-cmdrc.json
βββ .gitignore
βββ build
βββ public
β βββ favicon.ico
β βββ index.html
βββ src
βββ assets
β βββ images
β βββ fonts
βββ api
| βββ db.json
| βββ routes.json
βββ components
| βββ Account
| βββ CategoryHeader
| βββ likedSongs
| βββ Navbar
| βββ Sidebar
| βββ album
| βββ commonComponents
| βββ MainContent
| βββ Playlist
| βββ Subheader
| βββ Card
| βββ CreatePlaylist
| βββ MusicCard
| βββ Profile
| βββ WebPlayer
| βββ CategoryBody
| βββ GenreCard
| βββ MusicItem
| βββ SeeAll
βββ config
| βββ environment.js
βββ pages
| βββ Account
| βββ Home
| βββ Profile
| βββ Search
βββ routes
βββ utils
| βββ index.js
βββ App.css
βββ App.js
βββ index.css
βββ index.js
βββ setupTests.js
Unit testing
Each component in our project has its own unit test file separately eg. MusicCard.test.js
Running Unit tests
Run the following command.
npm run test
Generating Coverage Report
After running the following command an html version will be generated and located at coverage\index.html.
npm run test:coverage
Functional Documentation
Run the following command to generate the functional documentation report in docs/index.html
npm run docs
Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
Check out our contributing guidelines for ways to contribute.
Contributors
Thanks goes to these wonderful people in the frontend team.
Abdallah Hemdan |
Abdallah Abu Sedo |
Ahmed Walid |
Ahmed Ashraf |
Ahmed Mahboub |
License
This software is licensed under MIT License, See License for more information Β©AbdallahHemdan.