TAP Miniapp Examples

Public-facing example applications that demonstrate what developers can build with the TAP miniapp SDK and platform.

Workspace

This repository is a Turborepo monorepo managed with pnpm. Miniapps live under apps/ and can provide the standard dev, build, typecheck, test, and clean scripts consumed by the root task pipeline.

Publishing uses the private @zephyrcloudio/miniapp-zephyr-publisher package from GitHub Packages. Configure a user-level GitHub Packages token with read:packages before installing dependencies.

pnpm install
pnpm dev
pnpm build
pnpm typecheck
pnpm test

Target a single example with pnpm's workspace filter, such as pnpm --filter @tap-examples/family-task-board dev.

SDK versions

Each example exact-pins the SDK version it was verified against. Its tap-miniapp.config.mjs authoring source is compiled by that SDK, which owns the matching compatibility.tapSdk value in the staged descriptor. All current miniapps are verified against:

"@theaiplatform/miniapp-sdk": "0.15.0"

Do not copy an older SDK pin from a reference repository.

Miniapp Test Lab

Every descriptor-backed example includes a schema-v2 tap.test.json, SDK-owned Rstest configuration, deterministic fixtures, and capability-focused positive and denial cases. Validate the complete static inventory without a host session:

pnpm verify:tap

The repository gate runs the SDK doctor, list, matrix, and scaffold --check commands for every example, verifies exact SDK and runner pins, compares Rstest discovery with direct source declarations, and typechecks the host-driven suites. Executing those browser cases remains owned by TAP Miniapp Test Lab and requires its authenticated session file.

Each example has its own product brief under miniapps. The briefs are ordered for refinement; their status indicates whether the concept has been approved or remains proposed.

#	Miniapp	Audience	Data approach	Status
1	Family Task Board	Consumer	Application API plus platform capabilities	Approved
2	Brainrot Tower Defense	Consumer	Rust/WASM multiplayer using channel presence	Approved
3	Vanta Companion	Enterprise	Vanta API/MCP plus TAP knowledge and orchestration	Approved
4	Pyre	Enterprise	TAP knowledge, evidence, specialists, and workflows	Approved
5	Unofficial Suno Player	Consumer	Suno playback/generation plus channel workflows	Approved concept; provider-gated
6	Personal Health Ledger	Consumer	Private health records plus research and safety APIs	Approved
7	Engineering Change	Enterprise	App-defined plot ledger, CKG evidence, and policy-gated review	Proposed
8	Kart Royale	Consumer	TAP storage plus a Cloudflare session server for channel multiplayer	Approved concept; multiplayer implemented

Local references

Existing TAP and miniapp source repositories may be kept locally for implementation research, but are excluded from this repository. This includes tap-miniapps, tap-miniapps-labs, kent-courses, and ze-agency-tauri. The reference-repos directory is also ignored for future reference checkouts.