bible-strong-avatar-lab/AGENTS.md
smontlouis 3b2e134169 feat(studio): prepare app for GitHub release
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.
2026-08-13 18:56:47 +02:00

35 lines
1.4 KiB
Markdown

# 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
```bash
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`, `useCallback` or `memo`; React Compiler handles memoization.
- Add or update focused tests for domain behavior.
- Run `pnpm typecheck` and the relevant test file while working, then `pnpm check` before committing.
- `src/features/export/standaloneEngine.generated.ts` is generated. Update it with `pnpm engine`, never by hand.
- Keep English, French and Simplified Chinese copy synchronized across `src/i18n/index.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.