@expofp/offline

Offline: generating ZIPs

The @expofp/offline package provides a CLI (expofp-offline) that creates self-contained ZIP archives of floor plans. The ZIP can be opened in any browser without internet connectivity.

Usage

npx @expofp/offline@<tag-or-version> <manifest-url> [options]

Use a dist-tag or exact version to match the deployed floor plan (e.g. @latest, @stable, @customer1, @3.0.0-alpha.9).

Option	Description	Default
-o, --output	Output file path	offline.zip
--map-debug	Enable debug-only map flags. Do not use in production.
--no-offline-map	Disable automatic MapLibre basemap detection. Requires --map-debug.
--map-source	Global PMTiles source URL/path for offline maps. Requires --map-debug.	Latest available Protomaps daily build
-h, --help	Show help message
-v, --version	Show version number

Example

npx @expofp/offline@stable https://demo.expofp.com/manifest.json -o offline.zip

Offline MapLibre basemaps are inferred automatically from __fpGeo.properties.config:

npx @expofp/offline@next https://demo.expofp.com/manifest.json -o offline.zip

To skip automatic offline map generation for debugging only:

npx @expofp/offline@next https://demo.expofp.com/manifest.json \
  --map-debug \
  --no-offline-map \
  -o offline.zip

If --map-source is omitted, the CLI checks https://build.protomaps.com/YYYYMMDD.pmtiles starting from the current date and falls back to previous dates for up to 7 days. For debugging only, pass --map-debug --map-source explicitly to use a specific PMTiles URL or local file.

Offline map extraction requires the pmtiles CLI binary to be available in PATH. This is separate from the pmtiles npm package used by the browser runtime. On macOS, install the CLI with brew install pmtiles.

Debugging

Enable debug output with the DEBUG env variable:

DEBUG=efp:offline:* npx @expofp/offline https://...