Drum root is a React Web App for Creating and Sharing Drum Loops. See Drum Root API for Back End Service.
- Create Drum Loops
- Record Custom Sounds
- Save and Share Drum Loops With Others
- Installation
- Running
- Testing
- Building and Deploying
- Contributing
- Style Guide
- Technologies
- Team Leaders
- License
To get it working, you need to install all the dependencies. And the best way to do this is through the Command Line Interface (CLI).
To get started, make sure you have either of the package manager, NPM or Yarn installed and working on your machine.
To install the packages through npm, run the command
npm install
To install the packages through yarn, run the command
yarn add
NOTE: In the rest of the documentation, you will come across npm being used for running commands. To use yarn in place of npm for the commands, simply substitute npm for yarn. Example, npm start as yarn start. For more help, checkout migrating from npm
The backend code should be running in order for the front end to behave correctly. See Drum Root API.
To get started with the front end, fork the repository and run the following command on your local machine:
npm run dev
Storybook is a way to view the components in isolation. To view Drum Root's storybook, run the following command:
npm run storybook
If this is your first time running tests, begin by ensuring that the required packages are installed. install packages.
To get started with Unit Test, run the following command:
npm run test
To get started with Integration/End to End Test, run the following command:
npm run test:e2e
If you wanted to run this site in production, you should have installed packages. If not, install packages, then build the site with npm run build and run it with npm start:
npm run build
npm start
You should run npm run build again any time you make changes to the site.
Drum Root happily accepts contributions.
To begin contribution, there are some things you need to know, like what to do first, where to find tasks, any additional questions, and notes provided for contributors. You can begin at Contributing to Drum Root
We recommend every contributor to add their name to the contributors list. A detailed intructions on how to get this done be found at DRUM ROOT CONTRIBUTORS
The style guide is a set of standard outlined on how code should be written. We currently follow the AirBnB style guide, but you can checkout Drum Root style guide for any additional information.
- React - JavaScript UI Library
- Next.js - Server Side Rendering
- Styled Components - Styling
- Jest - JavaScript Testing Framework
- React Testing Library - A library to test React UI components
- Puppeteer - A Node Library for Controlling Headless Chrome or Chromium. Used for end to end Testing
- Storybook - Tool for Developing UI Components in Isolation
- Express - Web Framework for Node.js
- PostgreSql - Relational Database(Coming Soon)
- Redis - In-Memory Data Structure Store used for Authorization(Coming Soon)
- Project Lead - joshtru
- Front End Lead - needed
- Back End Lead - yashShelatkar
- QA Lead - zbc
- Database Lead - Aneesh
- Designer/ Styling Lead - LukasHirt
- rgavinc - Project Lead Oct 2019 - Jan 2020
- Dhaval - Front End Lead Oct 2019 - Nov 2019
- rvvergara - QA Lead Oct 2019 - Dec 2019
- marcoseoane - Front End Lead Nov 2019 - Dec 2019
- linconkusunoki - Designer/ Styling Lead Oct 2019 - Jan 2020
This project is licensed under the MIT License - see the License file for details