Skip to content
michaelsanfordPublic

Repository files navigation

Boomoji 🎈

A mobile-first PWA emoji toy for little kids. Tap. Pop. Discover.

Social Banner

Games

🎈 Pop

Bouncing emoji balloons float and spin around the screen. Tap one to pop it with a burst of confetti and a satisfying sound. Each round adds one more emoji — how far can you go?

✨ Reveal

A dark starfield canvas. Every tap reveals a surprise emoji with a sparkle burst. Swipe to give it momentum — it'll fly across the screen and gently fade away after a few seconds.

🌱 Grow

Hold your finger on the emoji to inflate it. The bigger it gets, the louder it hums — until it explodes in a shower of particles. Let go to deflate and try again.

🌧️ Rain

Emojis fall from the sky. Tap them before they splat on the ground! The longer you play, the faster they fall.

🌟 Stickers

Tap the canvas to place emoji stickers on themed scenes — Animals, Ocean, Yummy, Space, Garden. Fill up 15 stickers to complete a theme and unlock the next one.

🧩 Memory

Sixteen face-down tiles hide 8 pairs of matching emojis — all random every game. Tap two tiles to flip them; find the match to keep them revealed. Find all 8 pairs to win!

🔴 Connect

Two players take turns dropping their emoji piece into a 6×7 grid. The active player is shown large, glowing, and bouncing at the top — no reading required. Drop 4 in a row (across, down, or diagonally) to win! Coloured triangles above each column show where to tap.

👀 Spot

A target emoji is displayed at the top. The screen fills with bouncing emojis — a mix of the target and distractors. Find and tap every copy of the target emoji to win. Each round uses a new target and gradually adds more distractors.

Localisation

Boomoji supports four languages:

Code English name
en English
fr Français (French)
gu ગુજરાતી (Gujarati)
zh 中文 (Mandarin (Simplified))

The display language is auto-detected from navigator.language on first launch. Users can switch languages at any time via the 🌐 button in the menu footer; the choice is persisted to localStorage (boomoji-lang).

All strings — game titles, descriptions, celebration messages, badge text, and the full Privacy Policy — are translated. Translations live in js/i18n.js.

Parental controls

A row of buttons in the menu footer lets a parent set a play-time limit: Off, 15 min, 30 min, or 1 hr. Changing the setting requires solving an arithmetic challenge so children can't adjust it themselves.

Once the limit is reached the screen fades to an animated night scene — sleeping animals with drifting Zzz's — covering the entire display. No game interaction is possible and the home button is not accessible. To resume play a parent must tap the screen and solve the gate again; this clears the timer so the child gets a fresh session.

The same arithmetic gate also guards the Privacy Policy link in the menu footer.

PWA icons

The PNG icons aren't tracked in git. To generate them:

  1. Open icons/generate.html directly in a browser (no server needed)
  2. Three PNGs will auto-download: icon-192.png, icon-512.png, apple-touch-icon.png
  3. Move them into icons/

The SVG icon (icons/icon.svg) is tracked and sufficient for Android PWA installs.

Caching & offline

The service worker (sw.js) uses a cache-first strategy: every request is served from the cache; only cache misses hit the network. All JS, CSS, HTML, the manifest, and icons/icon.svg are precached on install. The three PNG icons are cached opportunistically — a missing file won't abort installation.

Deploying an update: bump the CACHE constant in sw.js. On next load the new SW installs, old cache versions are purged on activate, and the page reloads automatically to serve fresh assets.

Project structure

index.html          — menu screen + eight game screens
style.css           — animated gradient menu, game backgrounds, overlays
manifest.json       — PWA manifest (portrait, standalone)
sw.js               — service worker (cache-first, offline support)
js/
  i18n.js           — internationalisation; 4 locales (en, fr, gu, zh); t() helper
  app.js            — screen routing, fullscreen request, SW registration
  sounds.js         — Web Audio API synth: pop, sparkle, grow, boom, fanfare
  particles.js      — Particle class, spawnBurst(), shuffle(); shared EMOJIS[]
  pop-game.js       — bouncing physics, tap detection, round progression
  reveal-game.js    — starfield, touch/drag/inertia, emoji lifecycle
  grow-game.js      — hold-to-inflate, spring physics, explosion
  rain-game.js      — falling emojis, gravity, splat animation
  stickers-game.js  — themed canvas backgrounds, sticker placement, progression
  memory-game.js    — 4×4 flip grid, pair matching, bounce/glow animations
  connect-game.js   — two-player emoji Connect-4, falling pieces, 4-in-a-row win detection
  spot-game.js      — target zone display, bouncing emojis, visual search
  parent-gate.js    — arithmetic challenge overlay for parent-only actions
  sleep-timer.js    — parental play-time limiter; animated sleep overlay on expiry
icons/
  icon.svg          — source icon (tracked)
  generate.html     — open in browser to generate PNG icons

Tech

Vanilla JS · Canvas 2D · Web Audio API · CSS animations · No build step · No dependencies

License

Copyright (c) 2026 Michael Sanford. All rights reserved. See LICENSE.

Releases

Sponsor this project

Contributors

Languages