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)
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