Skip to content

N0zz/komyo.online

Repository files navigation

Komyo Games logo

Komyo Games

Open Komyo Games

Sponsor Buy me a coffee License: PolyForm Noncommercial 1.0.0


A little catalogue of self-contained browser games. Each game is its own folder of static HTML/Canvas + vanilla JS — no build step, no dependencies, no external assets — and gets a tile on the home page plus a top-left ‹ Menu / Komyo Games › nav. Every game follows the same flow: menu (pick a mode) → play → scoreboard (with share buttons). The home page groups tiles into Single player and Multiplayer sections.

Games

Game Folder About
Asteroids games/asteroids/ Fly/shoot/survive — classic arcade + roguelite modes, speedruns, mobile controls
Keep Defender games/tower-defense/ Fixed-path tower defense — towers, gold, mage/fast-forward/boss telegraph (Castle & Parchment theme)
Stack games/stacker/ One-tap tower stacker — slice the overhang, chain perfect drops (pastel-clean theme)
Neon Snake games/snake/ Grid snake in glowing neon — arrows/WASD/swipe, deadly walls
Meadow Flyer games/flappy/ One-tap flyer through a soft storybook meadow
Brick Breaker games/breakout/ Paddle/ball/bricks with power-ups and level progression (synthwave neon)
Range games/aim-trainer/ Timed flick-aim target practice with accuracy + combo (tactical theme)
Bubble Pop games/bubbles/ Puzzle-Bobble bubble shooter — match 3+, Arcade/Endless/Zen + special shots

More on the way — single-player (Sudoku, Invaders, Road Hop, Icy Tower, Trap the Cat, Pulse Dash, Dino Jump, …) and local multiplayer (Light Cycles 2–4P, Air Hockey, Slime Volleyball).

Stay updated: hit 📬 Subscribe on the home page to get an email when a new game ships or something gets fixed (free, no spam, unsubscribe anytime).

Install on your phone (PWA)

The arcade is a Progressive Web App — install it to play fullscreen & offline, no app store:

  • Android (Chrome): tap the 📱 Install button on the home page, or menu ⋮ → “Add to Home screen”.
  • iPhone (Safari): Share“Add to Home Screen”.
  • Desktop (Chrome/Edge): the Install button, or the install icon in the address bar.

Install individual games too. Every game is its own Progressive Web App — open a game and use Install / Add to Home Screen to put just that game on your home screen (its own icon, opens fullscreen, plays offline). Handy if you only want one.

Add a game

  1. Create games/<slug>/index.html — load the shared kit in <head> (game-kit.css + game-kit.js) and use gamekit.nav(), gamekit.sound, gamekit.shareRow(), gamekit.pwa() for the nav / sound + mute / share / PWA. Keep game logic inline with a window.__test hook and the menu → play → scoreboard(+share) flow.
  2. Add one entry to games.js: slug, title, blurb, icon, accent, tag, and optionally soon: true (greyed coming-soon tile), mp: true + players (e.g. "2–4P", Multiplayer section), badges: ["new"]/["pick"] (gold/purple tile badge).
  3. Add games/<slug>/test.mjs (dependency-free headless harness; preload ../../game-kit.js in the sandbox before the inline script) and keep it green.
  4. sw.js SHELL includes the HTML, icons, and ../../game-kit.js + ../../game-kit.css (offline).

Testing

node test.mjs                  # catalogue wiring + Keep Defender logic + boots every live game
node games/<slug>/test.mjs     # any single game's own suite (e.g. games/snake/test.mjs)
node games/asteroids/test.mjs  # the asteroids launcher's suite

Dependency-free headless harnesses (mock the DOM/canvas, drive each game via a window.__test hook). Keep them green.

Layout

index.html        catalogue (tiles from games.js) + PWA install + share + feedback + newsletter
games.js          catalogue manifest
analytics.js      consent-gated GA4 loader
game-kit.js      shared game shell (sound+mute, nav, share row, PWA auto-update)
game-kit.css     shared shell styles
favicon.svg       Komyo Games icon
manifest.json     PWA manifest      sw.js   service worker (offline)
CNAME             custom domain (komyo.online)   .nojekyll   serve files as-is on GitHub Pages
test.mjs          catalogue + Keep Defender harness
games/<slug>/     each game, standalone (index.html + test.mjs + manifest/sw/icons)

History note: games/asteroids/ was imported with git subtree so its full commit history is preserved — view per-game history on GitHub via the folder's History view (/commits/main/games/asteroids).

License

Source-available under the PolyForm Noncommercial License 1.0.0 — free to use, copy, modify and share for any noncommercial purpose; commercial use is not permitted. See LICENSE. © 2026 komyo.

About

Self-contained browser games — no dependencies, no ads, plays offline. 🕹️

Topics

Resources

License

Stars

Watchers

Forks

Contributors