What it does
- Loads real city model data: CityJSON (1.x and 2.x), CityJSONSeq, streaming FlatCityBuf, CityParquet, and zipped CityGML archives — from local files, URLs, cloud buckets, or the built-in Open3D City STAC catalog browser.
- Georeferences properly: every vertex is projected from its source CRS through proj4 (worldwide EPSG resolution) onto WGS84 ENU frames, with EGM2008 geoid-corrected heights — models wrap Google's Photorealistic 3D Tiles to metre accuracy.
- Colours by your rules: per-layer, attribute- or geometry-based rule styling with a legend, on static and streaming layers alike.
- Simulates sun and shade for any date and time, with a time-of-day animation.
- Analyses in the browser: DuckDB-wasm statistics over the loaded model — no backend, no login.
- Saves and shares: workspaces persist locally and share as URLs.
Tech
React 19 + TypeScript + Vite · Navara (@navaramap/three) on three.js · proj4 · DuckDB-wasm · Zustand · Vitest.
The CityJSON/FlatCityBuf/CityParquet engine plugins live in a submodule: cityjson-navara-plugins.
Development
git clone --recursive [email protected]:MultiRoofs/roofy.git
cd roofy
npm install
(cd packages/cityjson-navara-plugins && pnpm install)
npm run dev # via dotenvx — .env is encrypted, see CLAUDE.md
npm run test runs the app suite; the submodule has its own (pnpm vitest run inside it). See CLAUDE.md for the development guide and docs/architecture-notes.md for the architecture decisions and engine quirks.
Documents
About
Roofy is developed within the MultiRoofs European project at TU Delft, with a product focus on rooftop-centric urban planning — but it is a general-purpose city model viewer first.
Licensed under the MIT License.
