gitwtfhub

wtf is little-city?

craftmygame/little-city — explained in plain English

Analysis updated 2026-05-18

21JavaScriptAudience · vibe coderComplexity · 2/5Setup · easy

TL;DR

Little City is a browser game rendering real cities as small explorable 3D planets, starting with Taipei, designed so AI coding agents can easily add new landmarks via pull requests.

Mindmap

mindmap
  root((little-city))
    What it does
      Mini 3D city planets
      Real world landmark layout
      Browser playable
    Tech stack
      JavaScript
      three.js
      Antics multiplayer
    Use cases
      Explore Little Taipei
      Add landmarks via AI agent
      Play multiplayer rooms
    Audience
      Vibe coders
      Casual contributors

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Explore a hand-built miniature 3D version of Taipei directly in a web browser.

REASON 2

Use an AI coding assistant like Claude Code to add a new landmark or building to the city.

REASON 3

Play the multiplayer version through the Antics deployment with rooms and synced players.

What's in the stack?

JavaScriptthree.js

How it stacks up

craftmygame/little-cityamazingsyp/pokemon-ontologybinglehaepi/workingtable
Stars212121
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity2/53/51/5
Audiencevibe coderresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Must be served over HTTP, not opened as a local file, because the game uses native JS modules.

See the repository's LICENSE file, contributions are accepted under that same license.

Wtf does this do

Little City is a browser game project building a tiny, explorable planet version of real cities, starting with Taipei. Little Taipei renders the city as a small, cel-shaded globe with hand-placed landmarks like night markets, temples, Taipei 101, and the river, positioned using their real world bearing and distance from each other so the layout feels recognizably like the actual city. The project's stated goal is to eventually build a similar small planet for every city in the world, with Taipei as the first one. Running it locally just means cloning the repository and serving the folder over a simple HTTP server, since the game is built with native JavaScript modules that need to be loaded from a real web address rather than opened as a file directly. Once running, a player moves around with the WASD keys, jumps with the space bar, and interacts with objects using the E key. The project deploys through a service called Antics for its multiplayer features, like shared rooms, synced players, emotes, and leaderboards, without needing to run a separate server. Running it locally gives you solo mode only. The project is explicitly built to be easy to contribute to with the help of an AI coding assistant. The city is made of small, self-contained building and landmark files, so adding a new landmark or fixing a road is a naturally scoped task. Contributors are encouraged to open the repository in Claude Code or Codex, point the assistant at the project's contributing guide, and ask it to add a specific landmark, place it correctly in the city data file, and confirm it renders without errors before opening a pull request. One landmark per pull request is the suggested scope. The project is built with the three.js graphics library and is released under the license included in the repository.

Yoink these prompts

Prompt 1
Follow little-taipei/CONTRIBUTING.md and help me add a new landmark building to Little Taipei.
Prompt 2
Explain how city/taipei.js positions roads, parks, and landmarks using real world coordinates.
Prompt 3
Show me how to run Little City locally with python3 -m http.server and open it in a browser.
Prompt 4
Walk me through the build function structure used for buildings in little-taipei/buildings/.

Frequently asked questions

wtf is little-city?

Little City is a browser game rendering real cities as small explorable 3D planets, starting with Taipei, designed so AI coding agents can easily add new landmarks via pull requests.

What language is little-city written in?

Mainly JavaScript. The stack also includes JavaScript, three.js.

What license does little-city use?

See the repository's LICENSE file, contributions are accepted under that same license.

How hard is little-city to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is little-city for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.