Games, visualisations and interactive learning pieces for large multi-touch installations: rows of portrait touch panels under projectors, wide touch walls, kiosks and spherical displays. Each display loads one page of a static, frontend-only site that runs from any static host with no backend of its own. Pages that play together connect peer-to-peer with WebRTC, using a PeerJS broker only to find each other.
Live site: https://hypercube.adsm.dev/
/lists the pieces and builds the URL for each display./play/?app=<id>runs a piece. Addfit=1080x1920to preview a portrait panel on a phone or laptop./sim/simulates a whole installation in one browser tab.
Each title links to the piece's page on the site, which shows a live preview and builds the URLs to set it up. The last column lists the kinds of display it runs on:
- panel: a portrait touch panel
- pair: two panels side by side, used as one surface
- wall: a wide touch wall
- kiosk: a landscape touch screen
- screen: a large display above a row of panels, which nobody touches
- sphere: a spherical display
| Piece | What it does | Runs on | |
|---|---|---|---|
| Bluebottle Beach | Dig the sand together and work out where the bluebottles hide from the numbers, with no guessing needed. | panel, pair, wall, screen | |
| Crane Skyline | Send blocks to the yard and swing them up with a tower crane to build a skyline. | panel, pair, wall, kiosk, screen | |
| Many Hands | Quick tasks on every panel make parts for one big build that always gets finished. | panel, pair, wall, screen | |
| Pinball | Flippers low for children, flippers high for grown-ups, and deck shots fly up to the screen. | panel, pair, wall, screen | |
| Recycling Rush | Grab rubbish off the belts and throw it in the right bin; full bins build a park. | panel, pair, wall, kiosk, screen | |
| Table Hockey | Knock pucks into the other side's goal with a mallet that follows your finger. | panel, pair, wall, kiosk, screen | |
| Tangle | Steer a glowing line and stay off every trail. The last line moving wins. | panel, pair, wall, screen | |
| Tilt Maze | Tip a wooden maze with a big pad and roll the ball into the goal; finished balls shoot up into a marble run. | panel, pair, wall, kiosk, screen | |
| Touchdown | Two people, one engine each: work together to set a little spacecraft down on a pad. | panel, pair, wall, kiosk, screen | |
| Treetop Race | Tap to fly through the gaps and race everyone else on the same course. | panel, pair, wall, screen |
| Piece | What it does | Runs on | |
|---|---|---|---|
| Airflow | Put a wing, a car or a bird in a stream of smoke, turn it and change the wind, and watch the air part, swirl and shed eddies. | panel, pair, wall, kiosk, screen | |
| Answer Ball | A giant answer ball: it rocks, and in its windows a die rises out of dark liquid with an answer. On a wall, touch a ball to shake it. | wall, sphere | |
| Ball Pit Poll | Answer a picture question and watch your ball whoosh up a pipe into its tube. | panel, pair, wall, kiosk, screen | |
| Beach Ball | A sphere becomes a lazily spinning beach ball; on a wall, bat and throw beach balls and toys round a beach with an umbrella and a crab. | wall, sphere | |
| Big Eye | A realistic eye that darts glances round the room, at people below and level with it, and on a wall turns to whoever touches. | wall, sphere | |
| Brisbane Transit | Every bus, train and ferry in inner Brisbane moving on a live map. Light up a mode, follow a route, or drag and zoom the map. | wall, kiosk, screen | |
| Cake | The whole ball is a round cake under a glossy glaze: a Christmas pudding or one of four others. | sphere | |
| Chladni Plate | Ring a sand-covered plate, move where it is shaken, stretch or damp it, and watch the sand find the still lines. | panel, pair, wall, kiosk, screen | |
| Claw Machine | Claw machines that play themselves round the ball, or stand in a row on a wall for anyone to have a go. | wall, sphere | |
| Disco Ball | The ball becomes a mirror ball, turning slowly and sparkling with spotlights. | sphere | |
| Evolution | Catch the fish you can see. The hidden ones live to breed, and their family tree grows above the pond. | panel, pair, wall, screen | |
| Eye Lab | Change an eye's length, curve, age and light, see where light focuses and how a scene looks through it. | panel, pair, wall, kiosk, screen | |
| Fireworks | Build a firework shell, send it up and watch it burst in the sky above. | panel, pair, wall, screen | |
| Fish Bowl | A planted tank of fish, shrimp and snails behind the wall's glass, or the ball as a glass bowl of water with funny fish that come up to the glass. | wall, sphere | |
| Fourier Loom | Each slider and dial sets one sine wave; together they weave any shape. | panel, pair, wall, kiosk, screen | |
| Fourth Dimension | Push a 4D shape through our space and watch its slice grow, change and vanish. | panel, pair, wall, kiosk, screen | |
| Gravity Sandbox | Fling rocks, planets, gas giants and stars into a universe where everything pulls on everything else. | panel, pair, wall, kiosk, screen | |
| Hatching Egg | The ball is a hen's egg: it rocks, cracks round and opens, and a fluffy chick looks about. | sphere | |
| Hourglass | The ball is a giant hourglass: its sand runs out at a time you set, with a countdown round its collar and your own message below. | sphere | |
| Ink Mural | Pour warm ink that billows up the wall and settles into a layer for each hour, or steer a kaleidoscope with your hands. | panel, pair, wall, screen | |
| Kites | Hold a spool to send a kite climbing, or steer a stunt kite through rings on the breeze. | panel, pair, wall, screen | |
| Light Bench | Place mirrors, prisms and lenses and turn them to steer beams of light into the crystals. | panel, pair, wall, kiosk, screen | |
| Logic Lab | Flip big switches to light lamps, then wire logic gates between them to run a machine up on the wall. | pair, wall, kiosk | |
| Network Graphs | Explore a network: tap a node to see what it connects to. | panel, pair, wall, kiosk, screen | |
| Petri Dish | Seed a living culture with gliders, slime mould spores or drops of reagent and watch it grow. | panel, pair, wall, screen | |
| Robot Arm | Turn one dial per joint to swing a six-axis arm, grab a block and put it down. | panel, pair, wall, kiosk, screen | |
| Salute | The ball is a friendly face that turns to each side of the room and salutes. | sphere | |
| Sleeping Echidna | The whole ball is an echidna curled up asleep, breathing slowly and twitching now and then. | sphere | |
| Snow Globe | The ball is a giant snow globe: a little winter scene inside, snow drifting down, and a shake every minute or two. | sphere | |
| Sun, Earth and Moon | Carry the Earth round the Sun and watch the seasons, or the Moon round the Earth. | panel, pair, wall, kiosk, screen | |
| Ticker Ring | Rings of bright lettering crawl round the ball, so everyone round it can read them. | sphere | |
| Tiny World | Pour sand, water, seeds, fire and lava from your fingertips and watch them fall, flow and grow. | panel, pair, wall, screen | |
| Traffic | Touch a car to brake it and watch the jam you made travel backwards round the ring. | panel, pair, wall, screen | |
| Unit Circle | Turn a point round a circle and watch sin, cos and tan grow out of it. | panel, pair, wall, kiosk, screen | |
| Vision Orb | The ball becomes a dark glass orb full of swirling smoke, where now and then a faraway place clears and fades. | sphere | |
| X-Ray Diffraction | An interactive poster in eleven chapters on how X-rays show us the atoms inside a crystal. | panel, pair, wall, kiosk, screen |
pnpm install
pnpm dev
See AGENTS.md for the layout, URL parameters and how to write a piece.
Hypercube uses a few libraries at runtime:
- PeerJS for WebRTC connections between displays
- three.js for the 3D pieces
- planck.js for the claw machine's physics
- MapLibre GL JS for the transit map
- uqr for QR codes in the simulator
Everything else is written for this project: the pieces with their physics and simulations, the rendering, the networking on top of PeerJS (rooms, a relay hub and a shared clock) and the runtime that every display loads.
Hypercube's code is under the MIT licence (LICENSE). The build writes the licences of every library it bundles to third-party-licenses.txt, which the site serves and links from its footer.
- Brisbane Transit's route shapes and recorded vehicle positions in
src/apps/transit/data/are adapted from Translink's open data under CC BY 4.0: simplified to route ids, shapes and positions. - The transit map shows OpenFreeMap tiles in the OpenMapTiles schema, built from data © OpenStreetMap contributors. The app shows this credit on the map, and so do its screenshots here.