Agent Avatars

A searchable library of deterministic, pre-generated agent avatars. The MVP adds public download/open/copy actions, Supabase-backed accounts and favorites, and user-owned Agent Teams, delivered as a React/Vite application on Cloudflare Pages.

Architecture baseline

Implementation starts from these approved documents:

• tasks/plan.md — staged delivery plan and ownership
• docs/specs/mvp.md — product and engineering specification
• docs/decisions/0001-mvp-architecture.md — architecture decision record
• docs/decisions/0002-generator-adapters-and-provenance.md — multi-generator and AI-ready boundary
• docs/contracts/mvp-contracts.md — avatar, data, client, environment, and licensing contracts
• docs/acceptance-test-matrix.md — executable release requirements

Stage 2 modules share the repository-root tooling. Documentation integrity can always be checked with:

git diff --check

Identity data development

The Supabase identity foundation is under supabase/; its browser-safe typed entry point is src/lib/supabase/index.ts. Local database verification requires Docker and the pinned Node/npm versions:

npm ci --ignore-scripts
npx supabase start
npm run test:db
npm run check:database-types

Copy .env.example to an ignored local environment file and replace only the local public publishable key. Never place a service-role key or database secret in a VITE_* variable.