Skip to content

About

Browser build and play-testing harness for the WebOS games

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

WebOS Universal Game Harness 🪐

An independent, standalone test harness and preview application for the WebOS 2026 Game Suite (35 games).

The harness loads each game's synchronous mount(host) entry and exercises its browser layout in a small desktop shell. It emulates file operations in memory. Account persistence and deployment are verified in WebOS itself.

Run locally

Use Node.js 24 or later and a Chromium installation. Check out WebOS with the game submodules and shared libraries next to this checkout, or set WEBOS_ROOT to its location. The browser bundles are built from the selected games' source.

npm ci
npm run build
npm start

Open http://127.0.0.1:9876/ to switch games and phone, desktop, and 4K frames.

WEBOS_ROOT=/path/to/WebOS npm run build
CHROME_BIN=/path/to/chromium npm run test:browser
CHROME_BIN=/path/to/chromium node test_browser.mjs solitaire

The browser check waits for a game to finish mounting, switches layouts, then closes the view. The results and screenshots go to browser-results/. A failed mount, browser error, or missing layout fails the command.

The source was brought forward from the local harness snapshot 8ec838942df90a1c65722145c641f8b5c4aa421a. Build output and the browser's temporary profile are generated locally.

Chess Study running in the game harness

Supported Games (35 Total)

Tabletop, Brain & Toys (8)

  • solitaire — Klondike Card Table (Canvas 2D)
  • chess-study — Tabletop Chess Analysis (Canvas 2D + chess.js)
  • memory-garden — Tile Matching Memory Game (DOM)
  • story-cards — Branching Interactive Fiction (Canvas 2D / DOM)
  • marble-works — Track Building Mechanism (Canvas 2D)
  • expression-puppet — Dual Viewport Face & Pose Toy (Canvas 2D)
  • owl-companion — Virtual Desktop Companion (Canvas 2D)
  • reactive-control-desk — Instrument Panel Repair Sim (Canvas 2D)

2D Arcade & Strategy (7)

  • falling-blocks — Polyomino Falling Block Puzzle (Canvas 2D)
  • snake-garden — Grid Arcade Navigation (Phaser 4.2)
  • lantern-leap — Platformer Navigation (Phaser 4.2)
  • rhythm-garden — 4-Lane Rhythm Music Game (Canvas 2D + Web Audio)
  • sky-courier — Side-Scrolling Delivery (Canvas 2D)
  • crystal-defense — 3D Tower Defense Strategy (Babylon.js)
  • garden-defense — Lane Tower Defense Strategy (Phaser 4.2)

3D & Physics (13)

  • gravity-pinball — Tabletop Pinball Simulation (Three.js + Rapier)
  • stack-balance — Physics Tower Stacking (Three.js + Rapier)
  • sling-targets — Trajectory Ballistic Puzzle (Three.js + Rapier)
  • kinetic-relay — Tabletop Mechanism Machine (Three.js + Rapier)
  • physics-playground — Interactive Physics Sandbox (Rapier)
  • tabletop-bot-arena — Top-Down Combat Robot Arena (Three.js)
  • clockwork-quest — 3D Adventure Exploration (Babylon.js)
  • clockwork-room — 3D Puzzle Escape Room (Babylon.js)
  • drone-circuit — Time-Trial Flight Simulator (Babylon.js)
  • orbital-courier — Space Flight Navigation (Babylon.js)
  • pocket-golf — Miniature Golf Simulation (Babylon.js + Havok)
  • pocket-rally — Low-Poly 3D Rally Racing (Phaser 4.2)
  • target-garden — 3D Precision Target Aiming (Babylon.js)

Educational Cores (7)

  • fraction-farm — Fraction Arithmetic Puzzle
  • market-math — Currency & Transaction Puzzle
  • math-path — Arithmetic Pathfinding Puzzle
  • pocket-conquest — Turn-Based Strategy & Probability Odds
  • rule-detective — Inductive Pattern Recognition
  • tile-islands — Hexagonal Territory Exploration
  • word-weaver — Anagram & Vocabulary Web Puzzle

About

Browser build and play-testing harness for the WebOS games

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages