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.

Imagery and Terrain journey

Support · supported Lifecycle · active

imagery-cog-quickstart

Searches STAC, renders a bounded direct COG window in MapLibre, compares published imagery, and samples terrain elevation profiles.

View source →
SDK
@honua/sdk-js 0.1.7-beta.0
Data
mode hybrid · auth host-mediated · configuration approved
Evidence state
Fixture: executed Live: public-live · executed · evidence expires
Qualification
Receipt-qualified golden journey
Replacement
None
Capabilities
  • cog
  • elevation
  • imagery
  • profile
  • range-requests
  • raster
  • stac
  • terrain
Protocols
  • geoservices
  • stac
  • terrain-rgb
  • wms
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Qualified Imagery and Terrain journey with current packed-build, browser, accessibility, console, responsive, screenshot, performance, fixture, and pinned public STAC/COG live receipts.
Data provenance
Committed STAC, bounded COG range/decoded-window, imagery, and terrain fixtures; a configured same-origin Honua service; or the scheduled pinned Element 84 Earth Search Sentinel-2 item.
Attribution
STAC and elevation provider attribution, license, version, checksum, and ETag remain visible in workflow receipts; the pinned lane records ESA, Sinergise, AWS, and Element 84 attribution from its reviewed contract.
Freshness
Fixture acquisition/version metadata, configured-service response observation time, or the scheduled pinned-item observation time.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status executed Evidence reference samples/evidence/imagery-cog-quickstart/live.v1.json
Expected degradation
Credential-bearing URLs, CORS, missing or oversized range responses, unsupported CRS/format, and nodata return structured outcomes while published imagery remains usable. Public live proof covers classified COG inspection and a bounded decoded window in EPSG:32621; browser-side UTM reprojection and a georeferenced live MapLibre mount remain explicitly unclaimed.
Renderers
  • maplibre
Golden journey
Imagery and Terrain (imagery-terrain) · qualified
Quality profile
golden-browser — Canonical browser journey requiring the complete packed, browser, visual, performance, and live-evidence matrix.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive
  • screenshot
  • performance
  • liveEvidence

First Map: Maui census tracts in MapLibre

Support · supported Lifecycle · active

maplibre-quickstart

Starts with all 48 governed Maui County census tracts on an interactive map, then reveals the endpoint, accepted query plan, provenance, and protocol diagnostics behind it.

View source →
SDK
@honua/sdk-js 0.1.7-beta.0
Data
mode hybrid · auth anonymous · configuration approved
Evidence state
Fixture: executed Live: public-live · executed · evidence expires
Qualification
Receipt-qualified golden journey
Replacement
None
Capabilities
  • direct-connect
  • discovery
  • explain-plan
  • linked-views
  • map
  • provenance
  • query
Protocols
  • geoservices
  • ogc-features
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Qualified First Map journey with a governed 2025 Census TIGER/Line fixture, plus immutable packed-build, browser, accessibility, console, responsive, screenshot, performance, fixture, and separate anonymous live receipts.
Data provenance
Governed first-map/v2 fixture derived from the exact SHA-256-pinned 2025 U.S. Census Bureau TIGER/Line Hawaii tract archive, or the separate manifest-advertised anonymous live layer https://demo.honua.io/rest/services/maui-parcels/FeatureServer/1; the live lane is not represented as Census-governed.
Attribution
The fixture preserves the U.S. Census Bureau citation and disclaimer; live sources preserve endpoint-advertised attribution, and unavailable attribution is stated explicitly.
Freshness
The immutable fixture records its 2025-01-01 source vintage; live SDK observation time and cache status are shown separately.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status executed Evidence reference samples/evidence/maplibre-quickstart/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) · qualified
Quality profile
golden-browser — Canonical browser journey requiring the complete packed, browser, visual, performance, and live-evidence matrix.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive
  • screenshot
  • performance
  • liveEvidence

ArcGIS migration workbench

Support · supported Lifecycle · active

migration-workbench

Scans and transforms ArcGIS application source with auditable compatibility results.

Read the walkthrough →
SDK
@honua/sdk-js 0.1.7-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: demo-live · executed · evidence expires
Qualification
Receipt-qualified golden journey
Replacement
None
Capabilities
  • codemod
  • compatibility
  • migration
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Qualified ArcGIS Migration Workbench journey with immutable packed-build, browser, accessibility, console, responsive, screenshot, performance, fixture, and deterministic-CLI live receipts.
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 demo-live · status executed Evidence reference samples/evidence/migration-workbench/live.v1.json
Expected degradation
Unsupported ArcGIS modules are reported as manual work, never silently removed.
Renderers
  • maplibre
Golden journey
ArcGIS Migration Workbench (arcgis-migration) · qualified
Quality profile
golden-browser — Canonical browser journey requiring the complete packed, browser, visual, performance, and live-evidence matrix.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive
  • screenshot
  • performance
  • liveEvidence

Universal service explorer

Support · supported Lifecycle · active

service-explorer

Turns a service URL into inspected protocol truth, accepted plans, a bounded query, and copyable map code.

View source →
SDK
@honua/sdk-js 0.1.7-beta.0
Data
mode hybrid · auth anonymous · configuration approved
Evidence state
Fixture: executed Live: public-live · executed · evidence expires
Qualification
Receipt-qualified golden journey
Replacement
None
Capabilities
  • cancellation
  • capability-discovery
  • explain-plan
  • fidelity
  • map
  • protocols
  • provenance
  • query
Protocols
  • geoservices
  • odata
  • ogc
  • stac
  • wfs
  • wms
  • wmts
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Qualified Universal Service Explorer journey with immutable packed-build, browser, accessibility, console, responsive, screenshot, performance, fixture, and anonymous dual-protocol live receipts.
Data provenance
Same-origin deterministic GeoServices and OGC fixtures, or a reviewed credential-free dual-protocol public producer when explicitly enabled.
Attribution
Inspected source attribution remains visible; fixtures are Honua synthetic data and the scheduled defaults credit Esri and pygeoapi.
Freshness
Fixture replay is deterministic; a future scheduled public envelope records its observation time without changing feature-cache semantics.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status executed Evidence reference samples/evidence/service-explorer/live.v1.json
Expected degradation
Partial discovery and unsupported source actions remain visible with structured state, code, and reason; the sample does not synthesize success.
Renderers
  • maplibre
Golden journey
Universal Service Explorer (service-explorer) · qualified
Quality profile
golden-browser — Canonical browser journey requiring the complete packed, browser, visual, performance, and live-evidence matrix.
Required gates
  • packedBuild
  • browser
  • accessibility
  • console
  • responsive
  • screenshot
  • performance
  • liveEvidence

Map a bounded Arrow result

Support · experimental Lifecycle · active

columnar-query-quickstart

Executes an exact Honua Server Arrow fixture through bounded pushdown, decoding, cancellation, evidence, and a deterministic MapLibre handoff.

View source →
SDK
@honua/sdk-js 0.1.7-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
  • cancellation
  • columnar
  • map
  • query
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Map-first fixture workflow for exact Honua Arrow interoperability; Overture remains the complete production-shaped browser GeoParquet project.
Data provenance
Base64 text embedding of the exact 4,160-byte Honua Server geoarrow.wkb workflow artifact produced by reviewed head 66a9d34496c6f6a03dd571957062f773bfef7f0a, merged as 4ef53ce7f49b78aad3572db1dfc3be88a6654a43, and pinned by SHA-256, with its producer receipt and digest sidecar retained byte-for-byte.
Attribution
Honua Server interoperability fixture; the field extension declares EPSG:4326 PROJJSON and schema-level GeoParquet metadata declares Point.
Freshness
Fixture producer commit, schema contract, byte length, and SHA-256 are release-gated.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status not-applicable
Expected degradation
No public live Arrow or Parquet endpoint is claimed. Cancellation and row, batch, transfer, backing-memory, schema, geometry, or CRS violations stop explicitly; unsupported layouts never fall back to full materialization.
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

Bounded coverage quickstart

Support · experimental Lifecycle · active

coverages-wcs-basic

Renders named-band OGC API Coverages and WCS subsets through one MapLibre image handoff.

View source →
SDK
@honua/sdk-js 0.1.7-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
  • coverage
  • multidimensional-raster
Protocols
  • ogc-coverages
  • wcs
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Provide browser-qualified deterministic Coverages/WCS evidence while anonymous live canaries and connect discovery remain open.
Data provenance
Committed deterministic OGC API Coverages and WCS metadata plus a digest-pinned 320 x 220 fixture PNG, fail-closed in-memory transport, and MapLibre browser proof.
Attribution
Honua protocol contract fixture.
Freshness
Versioned with the repository and server contract.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Aborted superseded requests, invalid OGC properties, and invalid WCS range subsets leave the active bounded raster visible; unbounded, oversized, unsupported-format, and OWS exception responses fail with typed errors.
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

Conflict-aware editing workflow

Support · supported Lifecycle · replace

edit-workflow-demo

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

View source →
SDK
@honua/sdk-js 0.1.7-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
journey: Planning and Permitting (planning-permitting)
Capabilities
  • attachments
  • editing
  • optimistic-updates
Protocols
  • geoservices
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
replace — The planning and permitting journey now owns the complete metadata-backed search, bounded analysis, edit, attachment, conflict, recovery, and export workflow. · 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

Geocoding quickstart

Support · supported Lifecycle · active

geocoding-quickstart

Turns a reviewed address result into a synchronized MapLibre pin with score, locator, and provenance in view.

View source →
SDK
@honua/sdk-js 0.1.7-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
  • forward-geocode
  • map
Protocols
  • geoservices
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Credential-free map-first recipe with a self-contained GeocodeServer fixture route and focused desktop/mobile browser coverage.
Data provenance
Repository-owned synthetic Honolulu address response committed at the exact GeocodeServer route used by the SDK.
Attribution
Honua SDK deterministic sample fixture; no external geocoder attribution is claimed.
Freshness
Immutable for the built source revision; not presented as current real-world geocoder data.
Evidence details
Fixture mode fixture · status executed Live mode unavailable · status not-applicable
Expected degradation
A missing or invalid committed fixture route surfaces an explicit unavailable state; the sample never falls through to an ungoverned public geocoder.
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

Runs a deterministic Honolulu buffer job and renders the verified polygon result.

View source →
SDK
@honua/sdk-js 0.1.7-beta.0
Data
mode fixture · auth none · configuration not-required
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
  • 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
Data provenance
Pinned same-origin four-exchange geometry.buffer fixture with exact WKB inputs and GeoJSON digest.
Attribution
Honua geometry.buffer contract; Honolulu Hale location named in the fixture.
Freshness
Immutable fixture contract; no public-live result claim.
Evidence details
Fixture mode fixture · status executed Live mode authenticated · status planned
Expected degradation
Cancellation becomes dismissed; invalid inputs surface a structured problem without a fabricated result.
Renderers
  • svg
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

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.7-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.7-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.7-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

Focused React provider, hooks, and map-component recipe alongside the framework-neutral First Map journey.

View source → Open in StackBlitz → Open in CodeSandbox →
SDK
@honua/sdk-js 0.1.7-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 — Keep one focused React integration recipe without duplicating or redesigning First Map.
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 → Open in StackBlitz → Open in CodeSandbox →
SDK
@honua/sdk-js 0.1.7-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 — Retain as the focused terra-draw drawing, snapping, undo, and edit-submission recipe; the planning journey owns the end-to-end planning workflow.
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 · experimental Lifecycle · active

stac-imagery-browser

Searches Maui imagery by bounds and time, renders a selected preview, and inspects a signed PMTiles v3 handoff.

View source →
SDK
@honua/sdk-js 0.1.7-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
  • cancellation
  • cog
  • geoparquet
  • imagery
  • pmtiles
  • raster
  • stac
Protocols
  • pmtiles
  • stac
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Retain as the small credential-free STAC discovery recipe; the imagery journey owns full range, comparison, elevation, and terrain qualification.
Data provenance
Committed deterministic Maui STAC API responses, preview bytes, and an exact PMTiles v3 range fixture; no live service claim.
Attribution
Honua synthetic Maui product-evidence fixture.
Freshness
Pinned April-May 2026 fixture observations.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Unsupported or metadata-only assets remain visible without a handoff, signing is skipped for filtered assets, and cancelled or failed PMTiles inspection never becomes a tile-rendering claim.
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 → Open in StackBlitz → Open in CodeSandbox →
SDK
@honua/sdk-js 0.1.7-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.7-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 → Open in StackBlitz → Open in CodeSandbox →
SDK
@honua/sdk-js 0.1.7-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.7-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.7-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.7-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.7-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

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.7-beta.0
Data
mode fixture · auth none · configuration approved
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.7-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 journey

Support · supported Lifecycle · active

planning-permitting-workbench

Runs public SDK geocoding, metadata-backed queries, bounded geometry analysis, edit and attachment recovery, and review export against deterministic same-origin services.

View source →
SDK
@honua/sdk-js 0.1.7-beta.0
Data
mode fixture · auth none · configuration not-required
Evidence state
Fixture: executed Live: public-live · planned
Qualification
Planned golden candidate · not receipt-qualified
Replacement
None
Capabilities
  • attachments
  • editing
  • forward-geocode
  • geometry
  • linked-views
  • planning
  • provenance
  • query
Protocols
  • geoservices
  • honua
Evidence, provenance, lifecycle, and degradation
Lifecycle
active — Maintain the fixture-first public SDK workflow and source/packed browser gates as the planned planning candidate; golden qualification and live evidence remain explicitly unclaimed.
Data provenance
Committed versioned same-origin Maui planning metadata, geocoding, feature, edit, attachment, and deterministic failure fixtures.
Attribution
Honua synthetic Maui planning data; not a current regulatory determination.
Freshness
Fixture version and generated-at values are committed with the repository; no live freshness claim is made.
Evidence details
Fixture mode fixture · status executed Live mode public-live · status planned
Expected degradation
Metadata or capability discovery failure disables search, analysis, review export, and mutation without a local success fallback; the fixture hazard result is not a regulatory determination.
Renderers
  • none
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.7-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.7-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

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.7-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.7-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.7-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.7-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.7-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