Add distribution metadata, Strobi app icons, CI, and comprehensive documentation. Migrate the project to pnpm and reorganize the Studio into domain-focused modules and components.
1.4 KiB
1.4 KiB
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
pnpm dev
pnpm typecheck
pnpm test
pnpm build
pnpm 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,useCallbackormemo; React Compiler handles memoization. - Add or update focused tests for domain behavior.
- Run
pnpm typecheckand the relevant test file while working, thenpnpm checkbefore committing. src/features/export/standaloneEngine.generated.tsis generated. Update it withpnpm engine, never by hand.- Keep English, French and Simplified Chinese copy synchronized across
src/i18n/index.tsandsrc/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.