35 lines
1.3 KiB
Markdown
35 lines
1.3 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
|
|
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.
|