svc-sandbox/bible-strong-avatar-lab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
e547bc9f7b
bible-strong-avatar-lab/AGENTS.md
smontlouis e547bc9f7b feat: import standalone Avatar Lab
2026-08-13 18:31:27 +02:00

1.3 KiB
Raw Blame History

AGENTS.md

Project

Bible Strong Avatar Lab is a standalone React 19 + Vite 8 application for procedural SVG avatars. Read CONTEXT.md before changing behavior or persistence semantics.

Commands

yarn dev
yarn typecheck
yarn test
yarn build
yarn check

Engineering rules

  • Use TypeScript in strict mode.
  • Keep geometry, playback and document operations framework-independent.
  • Preserve the split between durable React state and high-frequency Motion values.
  • Do not use useMemo, useCallback or memo; React Compiler handles memoization.
  • Add or update focused tests for domain behavior.
  • Run yarn typecheck and the relevant test file while working, then yarn check before committing.
  • src/standaloneEngine.generated.ts is generated. Update it with yarn engine, never by hand.
  • Keep English, French and Simplified Chinese copy synchronized across src/i18n.ts and src/i18n.zh.ts.
  • Preserve project JSON compatibility only with the current pre-release schema unless a migration is explicitly requested.

UI conventions

  • Reuse components under src/components/ui/ rather than adding one-off controls.
  • Keep selection, hover, focus and destructive actions visually consistent across avatars, expressions and animations.
  • Prefer transform/opacity animation over layout animation for continuous interactions.