Sample apps/Starter

Weekend Trip Planner

Preserve Mappls place identity through a durable ordered itinerary, route revisions, progress, and completion.

JourneyStarter
Discover → save → sequence → preview → go → complete
Node.jsResponsive itinerary UISearch adapterRoutes 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.

15 implemented capabilitiesResponsive itinerary planner · Provider-backed discovery provenance · Mappls Pin identity continuity · Bounded duplicate-free stops · Exact sequence validation · Profile-aware multi-leg routes · Immutable route revisions · Automatic stale-route invalidation · Ordered visit and explicit skip progress · Pause, resume, and deliberate cancellation · Completion invariants · Idempotent commands · Optimistic concurrency · Transactional outbox · Restart recovery
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

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