opensourceprojects.dev

A broadsheet for software that doesn't ask for your email

A whole underwater world in one 96 KB HTML file, no assets
GitHub RepoViews31

Project Description

View on GitHub

You Can Swim Through a Whole Underwater World That Fits in a Single 96 KB File

Most 3D browser demos are a download away from being a download away—asset packs, model files, textures, a build step. So what if you could open one HTML file and find yourself gliding through a kelp forest with a sunken ship in the distance? That's the pitch behind Abyssal Garden, a dreamy underwater scene that ships as a single 96 KB HTML file with no images, no 3D models, and no sound files. Everything you see and hear is made by code.

What It Does

Abyssal Garden is an explorable underwater world you swim through in your browser. You'll find towering kelp forests swaying in the current, light rays pouring down from a rippling surface, a sunken wooden ship, a giant stone whale tail, rock arches and canyons, manta rays gliding overhead, schools of fish, rising bubbles, and a purple grotto with glowing magenta ground cover. The soundscape—a deep rumble, distant whale calls, soft chimes, bubbles—is generated live rather than played back from files.

Under the hood, the whole thing is drawn with WebGPU directly. No game engine, no 3D library. The seabed is sculpted on your graphics card each time the page opens, then decorated with roughly two million kelp leaves and plants, tens of thousands of rocks, and thousands of sponges, corals, and fish. The ship, whale tail, mantas, and corals are all built from simple mathematical shapes, and the audio is synthesized with the Web Audio API.

Why It's Cool

  • The constraint is the whole point. A 96 KB HTML file is smaller than most single images on a typical website. Achieving a full explorable scene at that size means every leaf, rock, and ripple is generated procedurally rather than stored. It's a nice reminder of how far clever math gets you.

  • No engine, no library. Building directly against WebGPU means the project isn't hiding behind abstractions, and there's nothing to install or bundle. It also means the result runs offline once you've got the file—download it, open it, and the world builds itself locally.

  • The scale is genuinely ambitious. Two million kelp leaves, tens of thousands of rocks, thousands of corals and fish. That's not a toy scene, and it's all computed on the fly.

  • It thinks about the hardware it lands on. There are three detail levels—High for computers, Medium for phones with 8 GB of memory, Low for other phones and computers with 4 GB or less. Low drops to a quarter of the leaves, skips anti-aliasing, and starts at 480p. If loading crashes the tab or the driver gives up, the page restarts one level lower, and your browser remembers the level and resolution that worked for next time. That's a thoughtful failure mode you don't see often in hobby demos.

  • Collision is handled sensibly. The seabed, cliffs, and arches are solid—you glide along rock instead of swimming into it—while kelp, plants, corals, the ship, and the whale tail are all pass-through, so you still fit through every tunnel and arch.

  • Touch support exists, even if experimental. Hold one finger to swim forward and slide to steer; a second finger goes faster. Phones always show the scene in landscape.

How to Try It

  1. Download index.html from the repository.
  2. Open it in Chrome or Edge on a desktop computer.
  3. Wait a few seconds while the world is built, then press Dive in.

Nothing to install, and it works offline. You'll need a browser with WebGPU—if you see "This scene needs WebGPU," update your browser or switch to Chrome or Edge.

Controls are straightforward: mouse to look, W A S D to swim, E and Q for up and down, hold Shift to go faster. Keys 1 through 6 jump you to the viewpoints shown in the screenshots, Esc opens the menu, M toggles sound, and H shows performance stats. The menu also has the Low, Medium, and High detail buttons (switching reloads the page).

Grab it here: github.com/noniv/abyssal-garden

Final Thoughts

Abyssal Garden is best for developers curious about what WebGPU can do without a framework in the way, and for anyone who enjoys a small, self-contained piece of generative art. It's not a library you'll integrate into a product, and it's desktop-first with touch support still experimental—so manage expectations there. But as a demonstration of procedural generation and tight constraints, it's a satisfying thing to open on a slow afternoon and just swim around in.

Back to Projects
Project ID: abyssal-gardenLast updated: November 16, 2026 at 07:11 AM