file-viewer/packages/renderers/geo

@file-viewer/renderer-geo

Standalone geospatial renderer package for Flyfish File Viewer. It previews GeoJSON, KML, GPX, and Shapefile data in the browser while keeping @tmcw/togeojson and shpjs lazy-loaded for geospatial files only.

Usage

import { geoRenderer } from '@file-viewer/renderer-geo'

const options = {
  builtinRenderers: 'none',
  renderers: [geoRenderer],
}

You can also compose it through the full preset:

import { allRenderers } from '@file-viewer/preset-all'

const options = {
  builtinRenderers: 'none',
  renderers: allRenderers,
}

Capabilities

• Reads GeoJSON FeatureCollection, Feature, and standalone geometry objects.
• Loads @tmcw/togeojson only for KML / GPX and normalizes them into the shared GeoJSON pipeline.
• Loads shpjs only for SHP / Shapefile previews, including common ZIP or binary Shapefile payloads.
• Does not depend on online map tiles. The default output is an offline SVG vector map, which is suitable for intranet deployment and attachment review.
• Cleans up DOM resources on unmount and remains compatible with core lifecycle, HTML export, and zoom orchestration.

Migration Note

@file-viewer/core no longer bundles the geo renderer and no longer installs @tmcw/togeojson or shpjs by default. Install this renderer explicitly, or use @file-viewer/preset-all, when GeoJSON / KML / GPX / SHP preview is required.