Row a Kerala snake boat through the backwaters at sunset, one beat at a time.
കായൽ താളം (kayal thaalam), "backwater rhythm"
Riverbeat is a free rhythm game that runs in your browser. You are the rhythm keeper on a chundan vallam, the long snake boat of Kerala's boat races. Waves roll down the river toward your oars. Press on the beat and the whole crew catches together. Miss, and the water churns and the stroke falls apart.
There is no download, no sign-up and no tracking. Everything is drawn in code and the sound plays offline.
| Play it | https://brej-29.github.io/Riverbeat/ |
| Genre | Rhythm game, one course, about 90 seconds |
| Controls | Keyboard, mouse, touch |
| Tech | TypeScript, Canvas 2D, Web Audio, Vite |
| Cost | Free, open source (MIT code) |
![]() |
![]() |
| Touch the glowing points on the title screen to learn what you are looking at. | Later in the run the sky moves from golden hour to blue hour and the lamps come on. |
![]() |
![]() |
Waves travel from the horizon to your oars. Press when a wave reaches the oar line. Steer between three lanes to collect lilies and dodge obstacles.
| Action | Keyboard | Mouse and touch |
|---|---|---|
| Stroke on the beat | Space, Up, or W |
Tap the river (this also steers to the lane you tapped) |
| Steer left or right | Left / Right, or A / D |
Tap the left, middle or right side of the river |
| Pause or resume | P or Esc |
Pause button |
| Restart | R |
Restart button |
| Mute | M |
Speaker button |
| Start or continue | Enter |
Buttons |
Scoring
| Result | Timing window | Points | Crew energy |
|---|---|---|---|
| Perfect | within 0.07 s of the beat | 100 | +4% |
| Good | within 0.14 s | 50 | +1.5% |
| Miss | outside that, or a beat that passes | 0 | -12% |
| Water lily | row over it | 150 | +5% |
- A streak of strokes in time raises the multiplier by 0.25 for every 10 in a row, up to ×2.
- Early mashing is punished: a press shortly before a beat but outside the Good window counts as a miss.
- Obstacles break your streak and tire the crew: drifting trunks, fishing stakes and weed mats.
- If crew energy reaches zero the run ends. Reach the end marker to finish.
- The course is the same every time (seeded), so you can learn it. Four sections add rhythm patterns as you go.
A short walkthrough opens the first time you press Begin the run.
The title screen has six glowing points. Each opens a short note about what you are looking at:
| Landmark | Malayalam | What it is |
|---|---|---|
| Chundan vallam | ചുണ്ടൻ വള്ളം | The snake boat, over 100 feet long, rowed to boat songs called vanchipattu |
| Vallam kali | വള്ളംകളി | Kerala's boat races, held around the harvest festival of Onam |
| Kayal | കായൽ | The backwaters, a chain of lagoons, lakes and canals behind the coast |
| Cheena vala | ചീനവല | Chinese fishing nets, lowered and hauled by a team |
| Kettuvallam | കെട്ടുവള്ളം | "Tied boat": once a cargo boat, now a houseboat lashed with coir rope |
| Kerala | കേരളം | A green strip of India's south-west coast between the Arabian Sea and the Western Ghats, with coconut palms along almost every waterway |
- Art direction. An animated illustration, not a lane game. Cached scenery layers (sky, palm ridge, banks, houseboats, a Chinese net) are reflected in the water with sine-warped strips, tinted by distance, and graded from golden hour to blue hour over the run.
- The beat is the animation. The crew's stroke is locked to the chart. Perfect catches splash together, Good catches jitter slightly, and a Miss makes rowers lag and muddies the water. Text is secondary.
- Audio. Percussion, drone and a pentatonic flute line are synthesised with Web Audio and scheduled against the same clock the judgments use. A bundled recording of the Pandi Melam adds the traditional drumming. Mute is remembered between visits.
- Speed. A frame-time monitor drops bloom and halves particles if the game runs slowly, aiming for a steady 60 fps on a mid-range laptop.
- Accessibility. Keyboard-complete, visible state in text, and the HUD exposes crew energy and journey progress as ARIA
meterandprogressbarelements. Sound is optional. - No network at runtime. Fonts (Fraunces, Instrument Sans, Noto Serif Malayalam) are bundled. There are no analytics, trackers or external requests.
You need Node.js and npm. It is tested on Node 24.
git clone https://github.com/brej-29/Riverbeat.git
cd Riverbeat
npm install
npm run devOpen the address Vite prints (usually http://localhost:5173).
| Script | What it does |
|---|---|
npm run dev |
Start the dev server |
npm run build |
Type-check with tsc, then build to dist/ |
npm run preview |
Serve the production build locally |
npm run check |
Run the pure-logic self-checks for audio timing and the rowing stroke |
npm run deploy |
Build and publish dist/ to the gh-pages branch |
In dev builds only, the course can be auto-played up to a point so you can inspect any moment. This is how the screenshots and GIFs above were captured.
| URL | Result |
|---|---|
/?shot=40 |
Hands-free play from the start, fast-forwarded to 40 s, then it carries on live |
/?shot=40&miss |
Same, but the last few beats before 40 s are missed |
/?shot=40&fail |
Misses every beat |
/?shot=40&pause |
Stops on the pause screen |
/?tutorial=3 |
Opens the walkthrough at step 3 |
| Path | Purpose |
|---|---|
index.html |
Page shell, HUD, overlays, SEO tags |
src/main.ts |
Game loop, phases, wiring |
src/state.ts |
Rules: judging, score, energy, collisions |
src/chart.ts |
The beat pattern and the lily and obstacle course (seeded) |
src/render/ |
Scene drawing: sky, water, boat, rhythm waves, post effects |
src/audio.ts, src/music.ts |
Synthesised sound and the bundled music track |
src/input.ts |
Keyboard, mouse and touch |
src/home.ts, src/tutorial.ts |
Title screen notes and the walkthrough |
public/ |
Icons, social image, robots.txt, sitemap.xml, web manifest |
scripts/deploy.mjs |
Dependency-free deploy to GitHub Pages |
The Vite base is relative, so the build runs from any path. For GitHub Pages:
npm run deployThis builds the game, pushes dist/ to the gh-pages branch of origin, and you then set Settings, Pages, Source to gh-pages (root). Any static host works too: upload the contents of dist/.
- Code: MIT.
- Music: "Pandi Melam" by Manojk, from Wikimedia Commons, licensed CC BY-SA 3.0. The converted file in
src/assets/stays under that licence. Details are in CREDITS.md. - Fonts: Fraunces, Instrument Sans and Noto Serif Malayalam, SIL Open Font License, via Fontsource.
The Malayalam and the notes about Kerala were written from general knowledge and have not been reviewed by a Malayalam speaker. Corrections are welcome as issues.



