Andrew_Game_Apps — Tiny Games Arcade

Music-teaching games for children (the Nuggets series), plus a small arcade of unrelated fun pages and the pipeline that renders the YouTube videos. Plain HTML and JavaScript, published straight to GitHub Pages.

Live: https://andrewlord311-sudo.github.io/Andrew_Game_Apps/

Layout

Folder	What it is
music/	The music-teaching games. music_arcade.html is the hub.
fun/	Unrelated one-off games, not part of the Nuggets series.
video-pipeline/	Renders the YouTube videos — Playwright records each HTML scene, ffmpeg muxes the audio and concatenates.
videos/	Rendered output.
voice_samples/	Narration audio, generated with ElevenLabs.
assets/	Shared images and mascot art.
firestore.rules	Pupil-tracking security rules — paste into the Firebase console.

The games

Note reading and keyboard orientation, mostly: stave_explorer_game, line_and_space_safari, clef_detective, space_face, face_finder, moo_clef, moo_keys, higher_lower_same, black_key_patterns, c_hunt, octave_hunt, alphabet_elevator, finger_numbers, name_that_part, meet_the_mascots.

Shared behaviour lives in game-progress.js (progress), reward-system.js (the reward loop), auth.js (pupil PIN) and back-link.js.

Pupil tracking, and its deliberate limit

Progress can be recorded to Firestore so a teacher can see how a pupil is doing. firestore.rules is intentionally low-security, and the header comment in that file says why: the PIN is a "make sure it's really you" speed bump for children, not an access boundary. The site is public and static, with no server to sit behind.

Never put anything beyond first-name-level information in pupils or events. These are other people's children.

Video pipeline

Requires npx playwright install chromium and ffmpeg. Two gotchas already paid for: narration is generated at 24 kHz mono while music bumpers are 44.1 kHz stereo, and concatenating mismatched audio silently corrupts playback — so normalise every segment (-ar 44100 -ac 2) before muxing. And scene timings come from the real narration durations, not the storyboard's estimates.

ElevenLabs credits are monthly and do not roll over.

Related

Design docs live in the vault under Claude Projects/Kids learning/Music teaching/ — start with Nuggets dashboard (status of every video + game); game notes are in Games/, video scripts and the launch plan in Videos and channel/.