🥁 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

Open in codespace

1. On the repo page, click the Code button → Codespaces tab → Create codespace on main.
2. A Codespace starts automatically. First creation takes a few minutes.

What happens on startup

• angular-frontend: runs npm install and installs Chromium (needed for Karma tests).
• scala-backend: runs sbt fastLinkJS and stays alive.
• The Angular dev server is forwarded on port 4200.

First sbt fastLinkJS run downloads dependencies and can take a while. The Angular app needs frontend/engine/main.js to exist before it runs.

🚀 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 or sbt fullLinkJS

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 🤔 🔊	Thomas Barbier 💡	Avnee Dadhich 💻	Draoui Haroun 💻	Prajwal 💻	Harshvardhan Kurade 💻	luisaromero 💻 🎨
Divya Dattaram Mhatre 💻 🎨	kirti7617 💻	fraydo23 💻	Weza Mwiwa 💻 🎨	Maeva Innocent 💻 🔊

• 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.