Open-source social twin-world built on Rust, Bevy and public Geo-data https://cartopolis.org
  • Rust 91.4%
  • TypeScript 6.2%
  • CSS 0.8%
  • Java 0.4%
  • Shell 0.4%
  • Other 0.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
cartopolis-agent d377b421cd perf(app): keep the cell JSON deflated on disk, and evict what was least used
A street-level visit left ~300 MB in the disk cache, which the startup
sweep caps at 512 MiB; 111 MB of it was the per-cell JSON layers stored
as plain text. Native cache entries ending `.json` are now deflated
(level 1, over 8 KiB) and inflated on read, told apart from entries
written before by the gzip magic: the same visit leaves 200 MB, and a
warm start was no slower. The web store is unchanged.

The sweep ordered by mtime, i.e. by when a file was fetched, so a city
opened every day sorted as old as its first visit and went before a place
seen once since. A cache read now sets the file's atime and the sweep
orders by the later of the two; the mtime stays the fetch time that
`storage::age_secs` reads for staleness.
2026-11-21 21:21:08 +00:00
.cargo feat(perf): measure what turning the camera costs 2026-10-17 08:02:53 +02:00
.claude feat(avatar): climb onto low walls and sit on wall and quay edges 2026-11-15 17:52:07 +00:00
.forgejo/workflows feat(deploy): install and update the server with one curl line 2026-11-12 21:24:45 +00:00
assets fix(android): keep atlas's neural networks out of the APK 2026-11-21 21:00:37 +00:00
crates perf(app): keep the cell JSON deflated on disk, and evict what was least used 2026-11-21 21:21:08 +00:00
deploy fix(deploy): embed Bun's release build in the script host 2026-11-17 12:31:26 +00:00
docs perf(app): keep the cell JSON deflated on disk, and evict what was least used 2026-11-21 21:21:08 +00:00
tools build(tools): measure the client's module graph and its cycles 2026-11-20 18:57:23 +00:00
.git-blame-ignore-revs build: gate rustfmt in CI, and keep git blame readable across the reformat 2026-08-06 17:20:50 +02:00
.gitattributes feat(atlas): measure facades and roofs from Groningen's city model 2026-11-20 18:01:54 +00:00
.gitignore refactor(avatar): retire the Quaternius characters 2026-10-18 10:11:03 +00:00
AGENTS.md refactor(workflow): take commit, finish-branch and handover from midas 2026-10-23 08:46:23 +00:00
Cargo.lock perf(app): keep the cell JSON deflated on disk, and evict what was least used 2026-11-21 21:21:08 +00:00
Cargo.toml build(deps): say ten shared dependencies' versions once, in the workspace 2026-11-19 19:39:56 +00:00
CHANGELOG.md refactor(core): split the protocol module into one file per topic 2026-11-19 19:52:58 +00:00
CLAUDE.md build(tools): check the crate graph against CLAUDE.md's dependency rules 2026-11-19 19:39:56 +00:00
LICENSE refactor(brand): rename viberfox to cartopolis, cool the surface ramp 2026-08-11 17:52:22 +00:00
LICENSE-APACHE feat(android): behave like an app the system can suspend, and answer Back 2026-08-10 22:27:18 +00:00
LICENSE-MIT refactor(brand): rename viberfox to cartopolis, cool the surface ramp 2026-08-11 17:52:22 +00:00
LICENSE-THIRD-PARTY.md feat(globe): colour the sea by its depth and let it move 2026-11-12 04:53:30 +00:00
README.md build(server): the package carries its version and a release to sign 2026-11-12 21:24:46 +00:00

Cartopolis

A shared, walkable 3D copy of the real world, built from open public data. Rust + Bevy. Runs on the desktop, in the browser and on Android, and you can host your own.

cartopolis.org (WebGPU) · desktop releases (x86_64 needs AVX2 + FMA) · Android APK

Six screens of the app: a building card, local chat, a private chat's map, map layers, route planning, the globe

Use it

Nothing to install for the web: open cartopolis.org in a browser with WebGPU.

  • Desktop: download from releases. Linux: unpack cartopolis-linux-x86_64.tar.gz and run ./run.sh. Windows: unpack the zip and run cartopolis.exe. Needs a GPU driver; x86_64 needs AVX2 + FMA.
  • Android: install the APK from cartopolis.org/apk.

The app starts with the map. To meet people, choose ☰ ▸ Sign in…: it signs in to cartopolis.org, or to your own server if you type its address under Server.

Host your own server

A server is one program, cartopolis-server: the shared world, accounts and chat, the website, and the map data and place search for its area. You need a Linux machine with systemd and a domain name pointed at it. Install Caddy first for HTTPS; the installer then sets it up too.

curl -fsSL https://cartopolis.org/server/install.sh | sh

It asks for the server's address and an admin account, starts the server and adds the address to Caddy. Open https://maps.example.org, or sign in from the app with maps.example.org as the server. The map data for your area is made from the website: sign in as the admin and open Admin ▸ Data.

Updates are offered on the server's Admin page: it looks for a new release every six hours, and shows only one signed by the Cartopolis maintainer. An admin installs it with one click; the server tests it on a copy of its database, keeps the previous version and database, and goes back to them by itself when the new one does not start.

The download is also at cartopolis.org/server; unpacked, ./install.sh does the same. To build it from source: deploy/build/server-package.sh. The server guide has the settings and how the hosted server is set up.

Build it yourself

Install Git LFS before cloning: fonts, icons and test fixtures are compiled in, and without LFS the build embeds pointer files and fails at runtime. Then cargo run -p cartopolis runs the app. Rust, a C compiler and a GPU driver are needed; Linux links with clang + lld. The development guide covers the dev loop, tests, the web and Android builds, the code map and CI.

Where it works

The map, sky, weather, routing and shared world work anywhere on Earth. Register detail is available for the Netherlands only: measured buildings and their records, relief, street objects, aerial photography and transit. Elsewhere the ground is flat and buildings come from OpenStreetMap.

Docs

Licence

Code is MIT OR Apache-2.0 (LICENSE). Data, models and the font carry their own terms. LICENSE-THIRD-PARTY.md is the canonical list; the credits below mirror it, so add new sources there.

Credits