How github-nqvnlc/windify-gis works
Windify GIS is a TypeScript GIS mapping package exposing a unified engine API and a declarative React wrapper over Leaflet. The main workflow is an application rendering a map, then adding GeoJSON layers, markers or clusters, and popups through React children or engine methods; tile basemaps and normalized events support that workflow. The graph includes the shared engine/event layer and spatial helpers. Several implementation relationships are based on the README or source-index references; unsampled behavior is not asserted as a confirmed call.
Main entry points: WindifyLeaflet.ts Leaflet adapter · WindifyMap.tsx WindifyMap · useWindifyMap.ts Map context hook · WindifyMarker.tsx Marker component
Components 17
React interface
- WindifyMap
src/react/WindifyMap.tsx - Map context hook
src/react/useWindifyMap.ts - GeoJSON component
src/react/WindifyGeoJSON.tsx - Marker component
src/react/WindifyMarker.tsx - Popup component
src/react/WindifyPopup.tsx - Marker context
src/react/WindifyMarkerContext.ts
Map engine
- Engine contract
src/core/AbstractWindifyEngine.ts - Leaflet adapter
src/core/leaflet/WindifyLeaflet.ts - Event emitter
src/core/events/WindifyEventEmitter.ts - Typed map API
src/core/types.ts
GIS data
- GeoJSON loader
src/core/geojson.ts - Spatial utilities
src/core/spatial.ts
Map configuration
- Tile catalog
src/constants/map-tiles.ts - Map defaults
src/constants/map-defaults.ts
Other components
- Application developer
- Tile providers
- Remote GeoJSON source
Connections 21
- Application developer → WindifyMap: renders
README.md - WindifyMap → Leaflet adapter: loads dynamically
src/react/WindifyMap.tsx - WindifyMap → Map context hook: provides state
src/react/WindifyMap.tsx - WindifyMap → Tile catalog: resolves basemaps
src/react/WindifyMap.tsx - GeoJSON component → Map context hook: reads engine
src/react/WindifyGeoJSON.tsx - GeoJSON component → Leaflet adapter: adds layers
src/react/WindifyGeoJSON.tsx - Remote GeoJSON source → GeoJSON loader: serves GeoJSON
README.md - Leaflet adapter → GeoJSON loader: loads data
src/core/leaflet/WindifyLeaflet.ts - Marker component → Map context hook: reads engine
src/react/WindifyMarker.tsx - Marker component → Marker context: uses context
src/react/WindifyMarker.tsx - Marker component → Leaflet adapter: adds markers
- Popup component → Map context hook: reads engine
src/react/WindifyPopup.tsx - Popup component → Marker context: uses context
src/react/WindifyPopup.tsx - Popup component → Leaflet adapter: adds popups
- Leaflet adapter → Engine contract: extends
src/core/leaflet/WindifyLeaflet.ts - Engine contract → Event emitter: delegates events
src/core/AbstractWindifyEngine.ts - Engine contract → Typed map API: implements API
src/core/AbstractWindifyEngine.ts - Leaflet adapter → Typed map API: uses options
src/core/leaflet/WindifyLeaflet.ts - Map defaults → Tile catalog: selects default
src/constants/map-defaults.ts - Tile catalog → Tile providers: references tiles
src/constants/map-tiles.ts - Spatial utilities → Typed map API: uses GeoJSON types
src/core/spatial.ts