Demo gallery

Runnable examples projected from the versioned SDK sample catalog. Public recipes and labs appear here now; qualified golden journeys join automatically as their evidence gates pass. Cards retain lifecycle, degradation, and evidence truth even when a sample is scheduled for replacement or retirement.

Conflict-aware editing workflow

Support · supported Lifecycle · rework

edit-workflow-demo

Demonstrates optimistic edits, attachments, conflicts, and safe recovery.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: demo-live · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • attachments
  • editing
  • optimistic-updates
Protocols
  • geoservices
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Keep the workflow and add an isolated resettable live dataset. · target release 0.2.0-beta.0
Data provenance
Committed deterministic edit fixture.
Attribution
Honua synthetic operations data.
Freshness
Deterministic fixture replay time.
Evidence details
Fixture mode fixture · status executed Live mode demo-live · status planned
Expected degradation
Editing is read-only when the service does not advertise mutation capability.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Endpoint to map: the standalone data-to-map bridge

Support · experimental Lifecycle · active

endpoint-to-map

mountSource() turns a public FeatureServer into a styled, interactive MapLibre map in four statements.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth anonymous · configuration approved
Evidence state
Fixture: executed Live: public-live · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • direct-connect
  • map
  • query
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Headline proof of the data-to-map bridge (#496): connect() plus mountSource() with no MapPackage or server.
Data provenance
Committed public-response fixture or public Esri Living Atlas endpoint.
Attribution
Endpoint attribution shown in the sample.
Freshness
Fixture retrieval metadata or live response time.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Strategy selection, overflow truncation, and capability gaps are reported through the mounted handle's diagnostics.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Geocoding quickstart

Support · supported Lifecycle · rework

geocoding-quickstart

Runs forward, reverse, and suggestion workflows with map feedback.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration legacy-unsafe
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • forward-geocode
  • reverse-geocode
  • suggest
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Move browser credential inputs behind a host-mediated flow before recipe promotion. · target release 0.2.0-beta.0
Configuration note
The browser bundle currently reads Honua API-key and bearer-token variables.
Data provenance
Committed gazetteer responses or configured Honua GeocodeServer.
Attribution
Gazetteer attribution supplied by the endpoint.
Freshness
Fixture capture metadata or live response time.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
The UI identifies fixture fallback when the live endpoint is unavailable.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Geoprocessing job runner

Support · supported Lifecycle · merge

geoprocessing-job-runner

Submits, polls, cancels, and inspects asynchronous geoprocessing jobs.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth bearer · configuration legacy-unsafe
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
journey: Cloud-Native Spatial Analysis (cloud-native-analysis)
Capabilities
  • async-jobs
  • cancel
  • geoprocessing
Protocols
  • geoservices
  • ogc-processes
Evidence, provenance, lifecycle, and degradation
Lifecycle
merge — Fold into the analysis journey while retaining this focused recipe. · target release 0.2.0-beta.0
Configuration note
The browser bundle currently reads a process-service token variable.
Data provenance
Committed job-state fixture or configured process endpoint.
Attribution
Process-owner attribution from service metadata.
Freshness
Job receipt and poll observation times.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
Unavailable or unlicensed processes are shown as structured capability gaps.
Renderers
  • none
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Imagery and COG quickstart

Support · supported Lifecycle · rework

imagery-cog-quickstart

Compares WMS imagery, COG-backed ImageServer tiles, and export previews.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration legacy-unsafe
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
Planned golden candidate · not receipt-qualified
Replacement
None
Capabilities
  • cog
  • imagery
  • raster
Protocols
  • geoservices
  • wms
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Consolidate the imagery candidate and its overlapping recipes before journey qualification. · target release 0.2.0-beta.0
Configuration note
The browser bundle currently reads Honua API-key and bearer-token variables.
Data provenance
Committed imagery metadata or configured Honua imagery service.
Attribution
Imagery-provider attribution is rendered on the map.
Freshness
Capture metadata or live response observation time.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
Unavailable raster operations remain visible and the supported preview lane stays usable.
Renderers
  • maplibre
Golden journey
Imagery and Terrain (imagery-terrain) · planned
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Honua × MapLibre flagship workflow

Support · supported Lifecycle · rework

maplibre-quickstart

Connects, discovers, explains, queries, and mounts one source with linked views and inspectable evidence.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth anonymous · configuration legacy-unsafe
Evidence state
Fixture: executed Live: demo-live · executed · evidence expires
Qualification
Planned golden candidate · not receipt-qualified
Replacement
None
Capabilities
  • discovery
  • explain-plan
  • linked-views
  • map
  • provenance
  • query
Protocols
  • geoservices
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Remove the rejected browser credential variables from the supported configuration surface before journey qualification. · target release 0.2.0-beta.0
Configuration note
The source still reads browser API-key and bearer-token variables in order to reject them.
Data provenance
Versioned Honolulu fixture replay or an anonymous configured Honua source, identified in runtime evidence.
Attribution
Source attribution and protocol identity are shown beside the map.
Freshness
Fixture capture time and data version, or live response observation time.
Evidence details
Fixture mode fixture · status executed Live mode demo-live · status executed Evidence reference examples/maplibre-quickstart/evidence/live.v1.json
Expected degradation
Capability misses, plan warnings, and bounded fallback are shown rather than silently returning an empty map.
Renderers
  • maplibre
Golden journey
First Map (first-map) · planned
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Node backend quickstart

Support · supported Lifecycle · active

node-backend-quickstart

Uses the protocol-neutral client from a Node service without browser dependencies.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration approved
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • node
  • query
  • server
Protocols
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Preserve the focused server-side installation and lifecycle path.
Data provenance
Committed mock responses or configured Honua endpoint.
Attribution
Response provenance is returned by the service.
Freshness
Fixture replay or live query observation time.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
The recipe fails explicitly when required server capabilities are absent.
Renderers
  • none
Golden journey
None
Quality profile
headless-recipe — Copyable Node or headless recipe requiring packed-package validation without browser presentation gates.
Required gates
  • packedBuild

OAuth sign-in

Support · supported Lifecycle · active

oauth-signin

Demonstrates browser authentication and session lifecycle without embedding credentials.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth oauth · configuration not-required
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • authentication
  • oauth
  • session
Protocols
  • oauth
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Retain as the focused browser authentication recipe.
Data provenance
Self-hosted deterministic OAuth identity-provider fixture.
Attribution
No spatial data is rendered.
Freshness
Fixture session issuance and expiry times.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
Live sign-in is unavailable until the host supplies an OAuth configuration.
Renderers
  • none
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

PMTiles static map

Support · supported Lifecycle · active

pmtiles-static

Loads a static PMTiles archive without a Honua server.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: public-live · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • offline
  • pmtiles
  • vector-tiles
Protocols
  • pmtiles
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Preserve the smallest server-optional vector-tile recipe.
Data provenance
Committed fixture-sized PMTiles archive.
Attribution
Archive attribution must be supplied by the host.
Freshness
Fixture version committed with the repository.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
The sample reports missing range-request support instead of fetching an unbounded archive.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

React quickstart

Support · supported Lifecycle · active

react-quickstart

Uses the React provider, hooks, and map component over the same quickstart contract.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration approved
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • map
  • query
  • react
Protocols
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Maintain framework parity with the canonical quickstart.
Data provenance
Committed quickstart fixture or configured Honua service.
Attribution
Service attribution shown in the map runtime.
Freshness
Fixture capture metadata or live observation time.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
The component exposes connection and capability errors through React state.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Interactive sketch editing with terra-draw

Support · experimental Lifecycle · active

sketch-editing

terra-draw draw modes drive the edit-sketch workflow: undo/redo, snapping, and applyEdits submission.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: public-live · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • editing
  • sketch
  • snapping
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Canonical terra-draw binding demo for the Esri widget-cliff sketch gap.
Data provenance
Committed deterministic harbor-parcel fixture.
Attribution
Honua synthetic operations data.
Freshness
Deterministic fixture replay time.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Sketch tools report unsupported capabilities when terra-draw is not installed; the SDK works without the optional peer.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

STAC imagery browser

Support · supported Lifecycle · merge

stac-imagery-browser

Discovers STAC collections and previews supported imagery assets.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: public-live · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
journey: Imagery and Terrain (imagery-terrain)
Capabilities
  • cog
  • imagery
  • stac
Protocols
  • stac
Evidence, provenance, lifecycle, and degradation
Lifecycle
merge — Fold into the imagery journey while keeping a focused STAC recipe. · target release 0.2.0-beta.0
Data provenance
Committed deterministic STAC catalog.
Attribution
Asset-provider attribution from STAC metadata.
Freshness
Fixture item datetime and catalog version.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Unsupported asset types retain metadata but disable rendering with a reason.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Standalone public-service quickstart

Support · supported Lifecycle · merge

standalone-quickstart

Connects a public Esri service directly to MapLibre without a Honua server.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth anonymous · configuration approved
Evidence state
Fixture: executed Live: public-live · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
journey: First Map (first-map)
Capabilities
  • direct-connect
  • map
  • query
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
merge — Make this direct-public path the zero-account mode of the canonical quickstart. · target release 0.2.0-beta.0
Data provenance
Committed public-response fixture or public Esri endpoint.
Attribution
Endpoint attribution shown in the sample.
Freshness
Fixture retrieval metadata or live response time.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Protocol capability gaps are surfaced without requiring a Honua facade.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Temporal playback

Support · experimental Lifecycle · active

temporal-playback

Animates a month of seeded synthetic seismic events with createTemporalPlayback, styled by a first-class classBreaksRenderer whose legend derives from renderer.legendItems().

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: unavailable · not-applicable
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • map
  • realtime
  • renderer-adapters
Protocols
  • geojson
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Canonical demo for first-class renderer objects + temporal playback (#497): renderer-driven styling, legend contracts, and filter-composed time windows.
Data provenance
Synthetic seismic events generated in the browser from a seeded PRNG; no network access.
Attribution
Honua synthetic demo data.
Freshness
Deterministic seeded generation per load.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status not-applicable
Expected degradation
Playback filters compose with bind-time layer filters; when MapLibre is unavailable the renderer objects still serialize and expose legend metadata headlessly.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Terrain RGB elevation

Support · supported Lifecycle · merge

terrain-rgb-elevation

Reads Terrain-RGB tiles for point elevation and route profiles.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration legacy-unsafe
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
recipe declaration · CI gates only; not receipt-qualified
Replacement
journey: Imagery and Terrain (imagery-terrain)
Capabilities
  • elevation
  • profile
  • terrain
Protocols
  • terrain-rgb
Evidence, provenance, lifecycle, and degradation
Lifecycle
merge — Combine point/profile proof with the imagery and 3D flagship. · target release 0.2.0-beta.0
Configuration note
The browser bundle currently reads Honua API-key and bearer-token variables.
Data provenance
Committed Oahu DEM fixture or configured terrain service.
Attribution
Elevation-source attribution displayed with results.
Freshness
Fixture asset version or live response time.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
Profile and map terrain expose independent capability failures.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-recipe — Copyable browser recipe with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Safe Agent Workbench

Support · experimental Lifecycle · active

ai-spatial-app-builder

Proves typed proposals, shared policy validation, signed single-use approval, bounded execution, refusal, and verified receipt states.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth host-mediated · configuration approved
Evidence state
Fixture: executed Live: unavailable · skipped · evidence expires
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • agent-approval
  • agent-planning
  • atomic-authorization
  • query-planning
  • receipts
  • typed-agent-tools
Protocols
  • geoservices
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — North-star safe-agent flagship rebuilt around plan-bound approval and receipts.
Data provenance
Committed parcel fixture plus optional host-mediated proposal and live-data endpoints.
Attribution
City and County of Honolulu — deterministic demonstration fixture.
Freshness
Fixture snapshot 2026-07-10; optional live lane records its observation time.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status skipped Target mode authenticated Evidence reference examples/ai-spatial-app-builder/evidence/live-skipped.v1.json
Expected degradation
Missing host endpoints produce a structured skip; mutation, realtime, and generated-app effects stay disabled without separate host policy.
Renderers
  • none
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Application bootstrap basic

Support · deprecated Lifecycle · retire

app-bootstrap-basic

Bootstraps a minimal application through the legacy app-platform compatibility surface.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: unavailable · not-applicable
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
external: @honua/app-platform (honua-app-platform)
Capabilities
  • app-bootstrap
Protocols
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
retire — The app-platform split supersedes this SDK-owned compatibility demonstration. · target release 0.2.0-beta.0
Data provenance
Committed bootstrap fixture.
Attribution
Honua fixture data.
Freshness
Deterministic replay.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status not-applicable
Expected degradation
Compatibility APIs are removed when the package advances to 0.2.0.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Cesium route playback lab

Support · experimental Lifecycle · rework

cesium-route-playback

Explores bounded route playback and elevation context through an optional Cesium consumer integration.

Read the walkthrough →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration legacy-unsafe
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • route-playback
  • terrain
  • three-dimensional
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Replace URL-query endpoint and ion-token configuration with the approved secret-safe configuration surface before promotion. · target release 0.2.0-beta.0
Configuration note
Live mode reads baseUrl and ionToken from URL query parameters; no configuration name is approved until the sample is reworked.
Data provenance
Committed route query fixture or an explicitly configured Honua feature layer.
Attribution
Route and terrain providers remain visible in diagnostics.
Freshness
Fixture version or live query observation time.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
Terrain, source Z, and 3D contract gaps are reported rather than promoted as production support.
Renderers
  • cesium
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Kepler operations analytics

Support · experimental Lifecycle · rework

kepler-analytics

Replays operations data through kepler.gl with linked filters and KPI evidence.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration legacy-unsafe
Evidence state
Fixture: executed Live: public-live · planned
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • analytics
  • linked-filters
  • replay
Protocols
  • geojson
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Retain as a renderer recipe and align it with the columnar large-data journey. · target release 0.2.0-beta.0
Configuration note
The browser bundle reads a public Mapbox token; it is explicitly classified as public, but the current browser policy does not approve credential values.
Data provenance
Committed Honua export with refresh metadata.
Attribution
Synthetic Honua operations fixture.
Freshness
Fixture metadata records the source retrieval time.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
The committed export is labeled replayed rather than live.
Renderers
  • kepler
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

MCP GIS assistant

Support · experimental Lifecycle · rework

mcp-gis-assistant

Demonstrates assistant tool discovery and safe SDK-backed spatial operations.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: demo-live · planned
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • agent-tools
  • mcp
  • query
Protocols
  • honua
  • mcp
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Use the same plan, provenance, approval, and evidence contracts as the agent journey. · target release 0.2.0-beta.0
Data provenance
Committed MCP response fixture.
Attribution
Tool results preserve source attribution.
Freshness
Deterministic fixture replay time.
Evidence details
Fixture mode fixture · status executed Live mode demo-live · status planned
Expected degradation
Write tools are unavailable without host policy and explicit approval.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

ArcGIS migration workbench

Support · supported Lifecycle · rework

migration-workbench

Scans and transforms ArcGIS application source with auditable compatibility results.

Read the walkthrough →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration legacy-unsafe
Evidence state
Fixture: executed Live: public-live · planned
Qualification
Planned golden candidate · not receipt-qualified
Replacement
None
Capabilities
  • codemod
  • compatibility
  • migration
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Make this the canonical file-by-file ArcGIS migration journey. · target release 0.2.0-beta.0
Configuration note
The browser bundle currently reads a cloud-admin API-key variable.
Data provenance
Committed ArcGIS source fixtures and migration reports.
Attribution
Fixture source attribution is preserved in output.
Freshness
Versioned with the migration corpus.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Unsupported ArcGIS modules are reported as manual work, never silently removed.
Renderers
  • maplibre
Golden journey
ArcGIS Migration Workbench (arcgis-migration) · planned
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Natural-language map control

Support · experimental Lifecycle · active

nl-map-control

A recorded fixture LLM compiles a canned instruction into an inspectable plan; read-only plans auto-execute, mutating plans require a signed agent-safety approval, and every execution emits a receipt beside the live map effects.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: demo-live · planned
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • agent-approval
  • agent-planning
  • agent-tools
  • map
  • receipts
Protocols
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Headline proof of the plan-first NL map-control layer (#500): BYO LLM, approval envelopes, and execution receipts on a live MapLibre map.
Data provenance
Committed recorded LLM completions and incident fixtures from test/fixtures/nl-map-control/.
Attribution
Honua demo fixture attribution is shown in the sample.
Freshness
Deterministic fixture replay time.
Evidence details
Fixture mode fixture · status executed Live mode demo-live · status planned
Expected degradation
Viewport and mutation plans refuse to execute without a verified approval envelope and report approval-required; the recorded LLM answers only the canned demo instructions.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Overture GeoParquet

Support · experimental Lifecycle · active

overture-geoparquet

Plans and executes bounded Overture GeoParquet queries with truthful worker, range, memory, and pruning evidence.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth anonymous · configuration not-required
Evidence state
Fixture: executed Live: public-live · planned
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • cancellation
  • columnar
  • geoparquet
  • large-data
  • progressive-rendering
  • range-reads
Protocols
  • geoparquet
  • s3
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Large-data flagship now shares one bounded semantic workflow across deterministic fixture and pinned AWS lanes.
Data provenance
Committed deterministic GeoParquet fixture or pinned Overture STAC item 2026-06-17.0/places/place/00000 on public AWS Open Data.
Attribution
Overture Maps Foundation Open Map Data with per-feature upstream sources preserved by the live schema.
Freshness
Pinned release, schema, object ETag, last modification, and execution observation time are shown separately.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Unsupported or malformed ranges, expired objects, unsafe plans, worker failures, the 10-second source-probe deadline, and the 30-second engine budget stop explicitly. DuckDB full-HTTP fallback is disabled; scheduled evidence rejects un-ranged GETs and measures browser range bytes, while rows scanned and row groups pruned remain unverified.
Renderers
  • svg
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Planning and permitting workbench

Support · supported Lifecycle · rework

planning-permitting-workbench

Combines parcels, hazards, sketching, editing, and export in a task-oriented application.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: demo-live · planned
Qualification
Planned golden candidate · not receipt-qualified
Replacement
None
Capabilities
  • editing
  • map
  • planning
  • query
Protocols
  • geoservices
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Retain as the primary complete-application journey and simplify its first task. · target release 0.2.0-beta.0
Data provenance
Committed Maui planning fixtures.
Attribution
Dataset attribution is visible per layer.
Freshness
Fixture version committed with the repository.
Evidence details
Fixture mode fixture · status executed Live mode demo-live · status planned
Expected degradation
Mutation and print actions disable with explicit reasons when capabilities are absent.
Renderers
  • maplibre
Golden journey
Planning and Permitting (planning-permitting) · planned
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Realtime incident operations

Support · supported Lifecycle · active

realtime-incident-dashboard

Runs live-first incident command with observable reconciliation and a guarded, resettable edit lab.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth anonymous · configuration approved
Evidence state
Fixture: executed Live: unavailable · skipped · evidence expires
Qualification
Planned golden candidate · not receipt-qualified
Replacement
None
Capabilities
  • idempotency
  • optimistic-concurrency
  • realtime
  • reconciliation
  • safe-editing
  • sse
Protocols
  • geoservices
  • sse
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Flagship realtime journey now proves authority, diagnostics, degradation, concurrency, idempotency, and safe reset.
Data provenance
Deployed demo stream when advertised; otherwise visibly labeled deterministic replay. Edits are limited to an isolated resettable fixture profile.
Attribution
Synthetic incident operations data.
Freshness
Snapshot, observation, and event times plus cursor, sequence, lag, reconnect, deduplication, and reconciliation outcomes.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status skipped Target mode demo-live Evidence reference examples/realtime-incident-dashboard/evidence/live-skipped.v1.json
Expected degradation
Unavailable live capability becomes a visibly labeled read-only replay; stale/offline state disables mutation, and live writes fail closed without an isolated resettable profile.
Renderers
  • maplibre
Golden journey
Realtime Incident Operations (incident-operations) · planned
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Runtime parity showcase

Support · experimental Lifecycle · replace

runtime-parity-showcase

Compares supported rendering paths and makes fidelity differences explicit.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: unavailable · not-applicable
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
journey: Universal Service Explorer (service-explorer)
Capabilities
  • fidelity
  • renderer-adapters
  • runtime
Protocols
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
replace — Replace parity claims with renderer-specific execution and fidelity reports. · target release 0.2.0-beta.0
Data provenance
Committed renderer comparison fixtures.
Attribution
Honua synthetic fixtures.
Freshness
Versioned with the repository.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status not-applicable
Expected degradation
Unsupported renderer operations are reported as fidelity differences.
Renderers
  • cesium
  • kepler
  • maplibre
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Universal service explorer

Support · supported Lifecycle · rework

service-explorer

Browses heterogeneous spatial services with capability and cache diagnostics.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration legacy-unsafe
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
Planned golden candidate · not receipt-qualified
Replacement
None
Capabilities
  • capability-discovery
  • catalog
  • protocols
Protocols
  • geoservices
  • odata
  • ogc
  • stac
  • wfs
  • wms
  • wmts
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Become the universal discovery and explain-plan journey. · target release 0.2.0-beta.0
Configuration note
The browser bundle currently reads Honua API-key and bearer-token variables.
Data provenance
Committed multi-protocol catalog or configured Honua catalog.
Attribution
Source attribution is retained per selected service.
Freshness
Metadata cache and live observation timestamps.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
Unavailable admin metadata falls back to service discovery with a visible diagnostic.
Renderers
  • maplibre
Golden journey
Universal Service Explorer (service-explorer) · planned
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Shared renderer state lab

Support · experimental Lifecycle · active

shared-renderer-state

Exercises loop-safe camera, selection, filter, and time synchronization across MapLibre and Cesium.

Read the walkthrough →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: unavailable · not-applicable
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
None
Capabilities
  • camera
  • filtering
  • selection
  • temporal
Protocols
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Retain as an integration lab for the renderer-neutral state synchronizer.
Data provenance
Deterministic renderer-neutral state fixture.
Attribution
Honua synthetic state fixture.
Freshness
Versioned with the repository.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status not-applicable
Expected degradation
Missing optional renderers fail their own lane without changing shared state semantics.
Renderers
  • cesium
  • maplibre
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Spatial analytics workbench

Support · experimental Lifecycle · rework

spatial-analytics-workbench

Explains and accepts one plan linking AOI, map, table, chart, provenance, and reusable output.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth anonymous · configuration approved
Evidence state
Fixture: executed Live: unavailable · skipped · evidence expires
Qualification
Planned golden candidate · not receipt-qualified
Replacement
None
Capabilities
  • aggregation
  • analysis
  • bounded-local
  • explain-plan
  • linked-views
  • provenance
Protocols
  • geoservices
  • ogc
Evidence, provenance, lifecycle, and degradation
Lifecycle
rework — Join the large-data journey and distinguish fixture estimates from executed plans. · target release 0.2.0-beta.0
Data provenance
Committed analysis fixtures or a configured public GeoServices source.
Attribution
Input/output attribution, source/schema versions, observation time, cache decision, and plan fingerprint are retained.
Freshness
Fixture replay uses a fixed observation; configured live execution records its observation time.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status skipped Target mode public-live Evidence reference examples/spatial-analytics-workbench/evidence/live-skipped.v1.json
Expected degradation
Remote fixtures are labeled replayed, bounded-local execution is capped, unsafe materialization is rejected, and OGC/DuckDB planner execution is a structured #389 follow-on.
Renderers
  • none
Golden journey
Cloud-Native Spatial Analysis (cloud-native-analysis) · planned
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

2.5D storytelling map

Support · supported Lifecycle · merge

storytelling-25d-map

Combines terrain, extrusion, OGC overlays, and route playback in a guided story.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode hybrid · auth api-key · configuration legacy-unsafe
Evidence state
Fixture: executed Live: authenticated · planned
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
journey: Imagery and Terrain (imagery-terrain)
Capabilities
  • storytelling
  • terrain
  • three-dimensional
Protocols
  • honua
  • ogc-features
Evidence, provenance, lifecycle, and degradation
Lifecycle
merge — Use its strongest interactions inside the imagery and 3D journey. · target release 0.2.0-beta.0
Configuration note
The browser bundle currently reads a Honua API-key variable.
Data provenance
Committed Oahu story fixtures or configured Honua services.
Attribution
Basemap, terrain, and thematic source attribution is displayed.
Freshness
Fixture capture or live layer observation time.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
Terrain and live overlays fail independently with structured status.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Unified operations workspace

Support · deprecated Lifecycle · retire

unified-ops-workspace

Composes incident command, analysis, and shared workspace state.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: unavailable · not-applicable
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
journey: Realtime Incident Operations (incident-operations)
Capabilities
  • analysis
  • realtime
  • workspace
Protocols
  • honua
  • sse
Evidence, provenance, lifecycle, and degradation
Lifecycle
retire — Application-shell ownership moves to app-platform; preserve the realtime SDK journey separately. · target release 0.2.0-beta.0
Data provenance
Committed operations workspace fixture.
Attribution
Synthetic Honua operations data.
Freshness
Deterministic snapshot and delta replay.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status not-applicable
Expected degradation
Deprecated app-shell APIs remain available only through their transition window.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive

Web components basic

Support · deprecated Lifecycle · retire

web-components-basic

Demonstrates the SDK custom-element controls against a map.

View source →
SDK
@honua/sdk-js 0.1.0-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: unavailable · not-applicable
Qualification
lab declaration · CI gates only; not receipt-qualified
Replacement
external: @honua/app-platform (honua-app-platform)
Capabilities
  • controls
  • custom-elements
  • map
Protocols
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
retire — Controls move with app-platform rather than remaining in the core SDK gallery. · target release 0.2.0-beta.0
Data provenance
Committed control-gallery fixture.
Attribution
Honua fixture data.
Freshness
Versioned with the repository.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status not-applicable
Expected degradation
Deprecated controls are linked to their app-platform replacements.
Renderers
  • maplibre
Golden journey
None
Quality profile
browser-lab — Exploratory browser integration with packed, browser, accessibility, console, and responsive gates.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive