Examples¶

This gallery collects the runnable sync samples and the manual workflows that the docs reference.

Runnable Scripts¶

• manual-exchange.sh
• scoped-tenant.sh
• conflict-demo.sh

Manual Exchange¶

The simplest demo is local export/import between two databases.

Use it when you want:

• an offline-only smoke test
• a deterministic batch file
• no network or server process

See the runnable script above and the quickstart.

Scoped Tenant Sync¶

This demo shows how a peer bound to a scope only moves scoped rows.

See scopes for the filtering rules and the script for a runnable localhost exchange.

Conflict Demo¶

This demo creates a deterministic conflict, inspects it, resolves it, and then reopens it.

See conflicts and the sample script.

Changeset Review¶

decentdb sync changeset create \
  --db=app.ddb \
  --from-branch=main \
  --to-branch=review \
  --output=.tmp/review.dcs.json

decentdb sync changeset inspect --input=.tmp/review.dcs.json --db=app.ddb --check-local

Use this when an application or agent needs a durable, inspectable data patch without merging a branch yet.

Relay Shape Snapshot¶

decentdb relay shape create \
  --db=app.ddb \
  --shape=tenant_42_tasks_v1 \
  --scope=tenant_42_tasks \
  --tenant=tenant_42 \
  --allow-role=user

decentdb relay shape snapshot \
  --db=app.ddb \
  --shape=tenant_42_tasks_v1 \
  --client-replica-id=web_123 \
  --output=.tmp/tenant_42_tasks.snapshot.dcs.json

Use this to test the same shape contract that browser and mobile clients consume through the production relay.

Doctor and Retention Workflow¶

decentdb sync doctor --db=app.ddb --format=table
decentdb sync prune --db=app.ddb --through=100 --dry-run --format=table

Use this pair before any pruning decision.