Skip to content
brej-29Public

About

Row a Kerala snake boat (chundan vallam) through the backwaters at sunset. A free, art-directed rhythm game for browser and phone, built with TypeScript, Canvas 2D and Web Audio.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Riverbeat

Row a Kerala snake boat through the backwaters at sunset, one beat at a time.

കായൽ താളം (kayal thaalam), "backwater rhythm"

Play now

License: MIT TypeScript Vite Runtime dependencies Works on phones

Gameplay: a chundan vallam snake boat rows through the backwaters at dusk, catching beat waves and collecting a water lily.

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)

Screens

The title screen. Glowing points on the scene open short notes about Kerala. Late in the run: blue hour, village lamps lit, a long combo and perfect catches.
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.
Gameplay at golden hour with the crew rowing and a water lily ahead. Riverbeat on a phone in portrait.

How to play

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.

What the scene shows

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

How it is made

  • 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 meter and progressbar elements. Sound is optional.
  • No network at runtime. Fonts (Fraunces, Instrument Sans, Noto Serif Malayalam) are bundled. There are no analytics, trackers or external requests.

Run it locally

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 dev

Open 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

Dev-only preview URLs

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

Project layout

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

Deploy your own copy

The Vite base is relative, so the build runs from any path. For GitHub Pages:

npm run deploy

This 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/.

Credits and licence

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

About

Row a Kerala snake boat (chundan vallam) through the backwaters at sunset. A free, art-directed rhythm game for browser and phone, built with TypeScript, Canvas 2D and Web Audio.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages