Sample apps/Starter

Store Locator

Discover eligible branches, compare distance and ETA, preserve Mappls Pin identity, and hand off safely to navigation.

JourneyStarter
Locate → discover → filter → rank → select → navigate
Node.jsResponsive map-and-list UINearby adapterMatrix adapter

A small app with production bones.

The download separates browser experience, command API, Mappls adapter, aggregate state, audit history, transactional outbox, fixtures, tests, and deployment guidance.

01Experience
02Mappls adapter
03Journey state
04Events + recovery
05Observability

Implemented and verified.

11 implemented capabilitiesResponsive synchronized map and list · Credential-safe server boundary · Nearby and matrix contract provenance · Stable Mappls Pin continuity · Service intersection filters · Opening and accessibility eligibility · Distance, ETA, and name ranking · Honest radius and empty states · Validated navigation deep links · Canonical bounded cache · Defensive cache isolation
Browser application

A responsive operations console backed by the included JSON API.

Durable domain

Aggregate snapshots, audit events, idempotency records, evidence, and outbox entries are committed together.

Fixture adapter

A credential-safe provider boundary aligned to named Mappls endpoint contracts.

Executable tests

6 tests covering lifecycle, HTTP, replay, conflicts, domain recovery, and restart behavior.

Architecture notes

Trust boundaries, aggregate invariants, adapter ownership, evidence lineage, and recovery design.

Deployment guide

Database, identity, secrets, outbox, privacy, observability, migration, and rollback work.