🥁 Drum Beat Repository

A library of drum patterns for music lovers / Une bibliothèque rythmique pour les mélomanes 🎵

Welcome to Drum Beat Repository, a web-based project for musicians to explore and create drum patterns. Built with Angular and the Web Audio API, this interactive tool delivers a smooth, in-browser drum sequencing experience.

👉 Try it now: www.drumbeatrepo.com

Requirements

1. Scala Engine ./engine : Scala and its build tool sbt
2. Angular Application ./frontend: Node.js

git clone https://github.com/Babali42/DrumBeatRepo.git

cd DrumBeatRepo/

cd engine/
sbt fastLinkJS

cd ../frontend/
npm run start

🚀 Quick Start

1. Engine (Scala)

Why ?

This scala engine is the core of the application, with the command/state modelling in a functional programming way.

It's my first scala project, I'm open to feedbacks, and PR !

Go into directory

Open a terminal in folder : cd engine/

How to test it

• Run all tests : sbt testFull
• Continously run tests : sbt "~test"

How to link it to Angular

• Build a js file in the frontend project directory : sbt fastLinkJS

2. Frontend (Angular)

Go into directory

Open a terminal in folder : cd frontend/

How to test it

• Run (angular) karma tests : npm run test
• Run vitest tests : npm run test-vitest

➡️ App runs at: http://localhost:4200

Contributing

Everyone is welcome — devs, musicians, designers.

🔍 Find something to work on

• Browse issues: https://github.com/Babali42/DrumBeatRepo/issues
• Start with: good first issue

🥁 Add a drum beat

• Pick a missing genre
• Either:
  • Comment on #270
  • Or implement it directly and open a PR

Contribution Workflow

1. Fork + create branch from main
2. Make changes
3. ✅ Pass all tests
4. Open a Pull Request

Contributors

GiaHuy0031 💻	Kireo 💻	Konscept440 🔊 🎨 💡	Linasti 🤔	jpeg729 🤔 💻	bLeclercDev 💻 🎨 🤔	Pelin Engin Duran 💻
Slaiker 🤔 🔊

• Louison for the ideation of the very first version of this app
• Etienne for the testing and the dub beat pattern
• Damien Musy for the blazing fast mobile ui sketch !

License

• Code: Licensed under the GNU General Public License.
• Non-code content (UI concepts, beats, etc.): Licensed under a Creative Commons Attribution-ShareAlike 4.0 license.