📈 GH Trending Explorer 🎲 Surprise me

← all repos

Khalidabdi1 / factory

git clone https://github.com/Khalidabdi1/factory.git

A live isometric world in the browser: a seaside town, a new city, a farming village and a Starship launch site, all simulated in real time. Built with Claude Opus 5.5, three.js, TypeScript and Next.js.

+2
stars, 24h · #5,728
+~14
stars, 7 days · #6,470
+143
stars, 30 days · #3,712
148
★ total · +11% this week
26
forks · 0 open issues

Star history (as recorded here)

2026-10-20 · 141 ★ 2026-10-23 · 148 ★
LanguageTypeScript
LicenseMIT
Created2026-10-04 (18d ago)
Last push11d ago
Watchers0
OwnerUser

GitHub topics

Links

README excerpt
# Factory Yard
A live isometric town drawn with WebGL in the hairline style of ai-iso-skill.
Goods go from a factory to a warehouse along the main road of a small seaside town, and on to a shop by the sea. East of
the town, past a green belt of woods, lies Sahel, a new city of towers, with a metro, a Metrobus, a car showroom and a
container port. Beyond Sahel the land rises into mountains, and the metro runs out through them to Millbrook, a valley
of farms. An observatory stands on Beacon Hill, and on a spit out over the sea below the valley, Starships are built and
launched:
- Behind both towns are hills; in front of them, the sea. Woods ring them round.
- A day passes in six minutes. Windows, street lamps, headlights and the lighthouse come on at dusk.
- There is no dashboard. Click anything and a card shows its live details; click a vehicle and its route appears.
## Open it
It's a Next.js app that builds to a static site. You need Node 20 or later.
 [code] 
Then go to .
To build the site, run `npm run build`. It writes plain HTML and JS to `out/`, so you can host it anywhere. To try the built copy locally, run `npm run preview`.
## How the code is laid out
| Folder | What's in it |
| --- | --- |
| `app/` | The page, the layout (which self-hosts DM Mono) and `globals.css` with the colour tokens |
| `components/YardFigure.tsx` | The plate around the map: caption, buttons, tags and the card. It loads the engine in the browser. |
| `yard/kernel/` | The iso projection, `Part` (boxes, faces, hairlines, text), `Path`, the corridor graph and the seeded random numbers |
| `yard/theme.ts` | Tokens → materials, and the day/night blend |
| `yard/models/`, `yard/world/` | Vehicles, people, boats, and the static town |
| `yard/land.ts` | The east country's land: the hills, the gorge and the moor, and the corridors cut through them for the line and the roads |
| `yard/sim/` | The simulation: clock, traffic, trucks, forklifts, people, homes, the shop and its courier, the police and the robbers, the fire station, the pier, fishing, weather, Car Works and the train; Sahel's traffic and people, the metro, the Metrobus, Sahel Motors, the port and the container truck; the east country, Millbrook, the observatory and Starbase |
| `yard/view.ts` | Camera, selection, card, routes, peeking into buildings, the frame loop, keys |
| `yard/index.ts` | Builds everything in a fixed order and starts the view |
The engine runs once per page load. React draws the plate, and the engine drives it from then on.
## The places
| Place | What's there |
| --- | --- |
| **Factory** | Plant 01, its conveyor, staging, two loading bays, a truck park for flatbeds waiting for a free bay, and the rail loading platform |
| **Warehouse** | Warehouse 01: two rows of racks three levels high, shelving with a packing bench and pickers, a loading lane, two docks, and a sliding gate with its guard |
| **Shop** | Corner Market on the seafront, where Hill Av meets Coast Rd: its delivery lay-by, a zeb