🎵 Rhythm Imitation App (Laravel + JS)

A desktop-focused web app for practicing and evaluating rhythm imitation, inspired by apps like Complete Rhythm Trainer and Rhythmer.

Built with:

• Laravel (API backend) for exercise structure, rhythm pattern storage, and progress tracking.
• JavaScript frontend for interactive rhythm playback and tap-based input.
• Designed to be auth-optional — anonymous play supported, with optional login for saving progress.

---

🔧 Features (MVP)

• 🎼 Rhythm pattern database (BPM, time signature, note durations)
• 🖱️ User input via tap key or button
• 🧠 Evaluation engine comparing taps to expected rhythm
• 📊 Progress tracking with scoring
• 📁 API-first architecture (RESTful endpoints)

---

🚧 Roadmap

• Add user authentication (optional)
• Rhythm pattern composer/editor
• Performance charts & streaks
• Audio latency calibration
• Gamification (XP, levels, medals)

About Laravel API Boilerplate

This is a boilerplate for writing RESTful API projects using Laravel. The aim of this boilerplate is to provide developers with scaffolding and common functionality which will make writing APIs exceedingly quick, efficient and convenient.

It is intended for this repository to be used when starting a new API project. Therefore, instead of cloning the laravel repository, you should clone this one.

The principles of this boilerplate are to;

• Save developers considerable effort by using reasonable conventions
• Allow for everything the boilerplate provides to be easily extended and entirely customised to suit developer needs, through normal PHP inheritance
  • As well as allow developers to easily use the boilerplate functionality and mix it in with their own implementation
• Follow REST standards very closely
• Use existing Laravel features and existing Laravel add-on packages where possible
• Add many convenient features useful for writing APIs
• Maintain a high level of performance

Development

To compile SASS and move JS, webpack mix is used; it can be run using (see package.json):

npm run watch

Check out the documentation of supporting projects

Every great project stands on the shoulders of giants. Check out the documentation of these key supporting packages to learn more;

• Laravel
• Dingo API
• Tymon JWT Auth
• League Fractal
• Laravel UUID

Recommended Packages

I have tried to include only the packages thought absolutely necessary, so here is a list of packages I recommend checking out:

General

• PHP CodeSniffer
• PHP-VCR

For Debugging

• Bugsnag for Laravel
• Sentry