Roofy

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

• Design Doc
• Roadmap
• Repository Setup
• Testing Strategy
• Agent Guide

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.