Local runtime preview
← Batten / Design guide

THE APPLICATION SDK, EXPLAINED

Approval desk walkthrough

Runnable local preview. Follow this journey as a requester and independent approver. Use fabricated data throughout.

Install and start the local app before following these steps. The preview uses loopback development identities and PostgreSQL 18; production authentication and broader fleet qualification remain separate.

Capabilities in this journey

tables, actions. These tags describe requested integration boundaries.

1. Open the local registry

Follow the install instructions, then explicitly initialize a new fabricated database with `batten-approval init`. Start the host with `batten-approval serve`, open its root registry and choose Approval desk.

2. Submit as Alex

Choose Alex in Local identity. Enter a fabricated summary in Request summary and select Submit for review. Select the pending request to inspect its current revision.

3. Revise before deciding

As Alex, change the pending summary and select Save changes. The requester can edit but cannot approve their own request.

4. Review as Blake

Switch to Blake, the independent reviewer. Refresh and inspect the current request before selecting Approve request or Reject request. A decision based on an older revision must refuse.

5. Inspect the original outcome

Confirm the final state and decision identity. If a response is lost, use Check original outcome with the retained attempt rather than submitting a fresh command. The Batten brand returns to the registry.

Check authority and recovery

Repeat inspection as an anonymous, foreign or revoked actor. No private result or unauthorized mutation should appear. If an operation may have taken effect, inspect its original identity and retain uncertainty until the result is known.

Continue exploring

Read the example app README.

Read the design sources ↗
Explore the composition ↗