Summary

Mini Taiwan Pulse is a sophisticated, real-time geospatial visualization project that renders dynamic transportation data (flights, ships, trains) and various other Taiwanese public data layers (weather, population, infrastructure) onto an interactive 3D map. It targets users interested in data visualization, urban planning, and understanding Taiwan's dynamic pulse, offering a rich, explorable interface powered by open data.

How It Works

The project leverages React, Mapbox GL JS, and Three.js to create a visually rich 3D environment. It integrates real-time data streams from sources like FlightRadar24, AIS, and Taiwan's TDX platform, alongside static and near-real-time data for infrastructure, weather, and demographics. Data is processed and optimized using Supabase RPC pre-aggregation and managed via declarative registries for overlays and data sources. Custom Three.js layers are embedded within Mapbox GL JS for advanced visualizations like light trails, spheres, and animated surfaces, while H3 is used for hexagonal grid-based analytics.

Quick Start & Requirements

• Primary install/run: npm install, set VITE_MAPBOX_TOKEN in .env, then npm run dev. For local deployment, use docker-compose up -d.
• Prerequisites: Node.js 22+, Python 3, Mapbox Access Token.
• Links: Project Repository (implied by context).

Highlighted Details

• Comprehensive real-time visualization of flights, ships, and trains with 3D light trails and spheres.
• Integrates over 20 data layers including weather, population density, road networks, and disaster alerts.
• Advanced architectural patterns: Declarative Overlay Registry, Data Source Registry, Supabase RPC pre-aggregation, and Three.js CustomLayer integration.
• Interactive controls for layer visibility, visual parameters, timeline playback, and data exploration.

Maintenance & Community

No specific community links (Discord/Slack) or notable contributors/sponsorships are mentioned in the provided text. The project structure and detailed data preparation scripts suggest active development.

Licensing & Compatibility

Licensed under the MIT License, permitting commercial use and closed-source linking.

Limitations & Caveats

No explicit limitations are stated in the provided text. The project appears to be a mature, feature-rich application with a focus on robust implementation.