Real TinyCloud apps for the "anatomy of interoperable apps" talk.

This repo is a workspace for independent TinyCloud apps. It currently contains:

• Food Tracker: logs meals from photos or manual edits.
• Pain Tracker: logs pain events with severity, body location, quality, duration, and notes.
• Insight: an agent-style app that discovers the other app manifests in the TinyCloud applications space and correlates meals with pain events.

Each app is its own package under apps/. Shared code lives in packages/appkit.

The apps are intended to write to real TinyCloud spaces. They do not seed mock records and they do not use a local data simulator. Each app stores its data and manifest under its app-id prefix in the TinyCloud applications space.

npm install
npm run dev:food
npm run dev:pain
npm run dev:insight

Default dev ports:

• Food Tracker: http://localhost:5173
• Pain Tracker: http://localhost:5174
• Insight: http://localhost:5175

Food photo interpretation is served through the Food Tracker app's /api/analyze-food route during local development.

Open Food Tracker settings and store your Anthropic API key in your TinyCloud secrets space. The app reads that user-owned key and sends it with photo interpretation requests.

No shared Anthropic key is used, and no real API key should be committed. Without a user-provided key, Sonnet photo interpretation is unavailable; users can still enter meals manually.

Deploy each site as its own Cloudflare Pages project from the repo root:

The app targets are single-page apps. TinyCloud provides identity, manifests, and user-owned storage, so the apps do not need an app database or app backend for their core data flows.

Food photo interpretation is the only backend-shaped concern. The local Food dev server provides /api/analyze-food and only accepts the user's key from TinyCloud secrets; deployed SPA-only builds can still log meals manually.

See SPEC.md for app ids, manifests, data paths, and app flow.