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.
Recipe and lab cards are catalog declarations, not receipt or artifact
qualification claims. Publication runs npm run samples:verify, which validates the complete receipt
set before any future qualified golden journey is published; profile gates alone are only requirements.
32 of 32 public samples
No public samples match these filters. Clear a filter or try a broader task.
Golden journeys
Imagery and Terrain journey
Support · supportedLifecycle · active
imagery-cog-quickstart
Searches STAC, renders a bounded direct COG window in MapLibre, compares published imagery, and samples terrain elevation profiles.
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 executedLive mode public-live · status executedEvidence 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 · supportedLifecycle · 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.
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 executedLive mode public-live · status executedEvidence 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 · supportedLifecycle · active
migration-workbench
Scans and transforms ArcGIS application source with auditable compatibility results.
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 executedLive mode public-live · status executedEvidence 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
Recipes
Map a bounded Arrow result
Support · experimentalLifecycle · active
columnar-query-quickstart
Executes an exact Honua Server Arrow fixture through bounded pushdown, decoding, cancellation, evidence, and a deterministic MapLibre handoff.
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 executedLive 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 · experimentalLifecycle · active
coverages-wcs-basic
Renders named-band OGC API Coverages and WCS subsets through one MapLibre image handoff.
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 executedLive 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 · supportedLifecycle · replace
edit-workflow-demo
Demonstrates optimistic edits, attachments, conflicts, and safe recovery.
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 executedLive 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 · experimentalLifecycle · active
stac-imagery-browser
Searches Maui imagery by bounds and time, renders a selected preview, and inspects a signed PMTiles v3 handoff.
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 executedLive 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 · experimentalLifecycle · 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().
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 executedLive 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 · supportedLifecycle · merge
terrain-rgb-elevation
Reads Terrain-RGB tiles for point elevation and route profiles.
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 executedLive 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 · experimentalLifecycle · rework
kepler-analytics
Replays operations data through kepler.gl with linked filters and KPI evidence.
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 executedLive 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 · experimentalLifecycle · rework
mcp-gis-assistant
Demonstrates assistant tool discovery and safe SDK-backed spatial operations.
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 executedLive 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 · experimentalLifecycle · 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.
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 executedLive 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 · experimentalLifecycle · active
overture-geoparquet
Plans and executes bounded Overture GeoParquet queries with truthful worker, range, memory, and pruning evidence.
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 executedLive 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 · supportedLifecycle · 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.
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.
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 executedLive 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 · supportedLifecycle · active
realtime-incident-dashboard
Runs live-first incident command with observable reconciliation and a guarded, resettable edit lab.
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 executedLive mode unavailable · status skippedTarget mode demo-liveEvidence 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.
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 executedLive mode unavailable · status skippedTarget mode public-liveEvidence 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.
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 executedLive 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
Published evidence
The same generated-from-committed-artifacts discipline these cards use, applied to the
claims that are easiest to fake:
Cross-model MCP eval scorecard — how different client models score driving Honua's MCP surface, including the zero-LLM control row and every non-passing run.