callstack__react-native-testing-library/agents/example-apps.md

# Example App Regeneration

## General workflow

- Regenerate Expo example apps in a temporary directory, then copy the fresh scaffold into place.
- Before replacing an example app, move the current app directory to `/tmp` so repo-specific files can be restored selectively.
- Avoid image churn: preserve existing tracked image assets unless the task explicitly asks to update them or the new SDK requires an asset change.
- After copying a generated app into `examples/`, remove the generated `.git` directory and `node_modules`, then reinstall from inside the repo workspace.

## `examples/basic`

- Generate from the Expo blank TypeScript template:
  - `yarn create expo-app /tmp/rntl-basic-fresh --template blank-typescript --yes`
- Restore these repo-specific files on top of the fresh scaffold:
  - `App.tsx`
  - `components/`
  - `__tests__/`
  - `theme.ts`
  - `jest.config.js`
  - `jest-setup.ts`
  - `babel.config.js`
  - `eslint.config.mjs`
  - `README.md`
  - `AGENTS.md`
  - existing tracked image assets in `assets/`
  - `.expo-shared/assets.json` if it existed before
- Keep the fresh Expo entrypoint `index.ts`.
- Update `package.json` and `app.json` to match repo naming and scripts. Keep `app.json` pointing at the restored existing image assets unless changing them is intentional.

## `examples/cookbook`

- Generate from a router-enabled Expo scaffold:
  - `yarn create expo-app /tmp/rntl-cookbook-fresh --example with-router --yes`
- Restore these repo-specific files on top of the fresh scaffold:
  - `app/`
  - tutorial test directories such as `basics-tutorial/` and `basics-tutorial-react-strict-dom/`
  - `theme.ts`
  - `jest.config.js`
  - `jest-setup.ts`
  - `babel.config.js`
  - `.eslintrc`
  - `.eslintignore`
  - `README.md`
  - `AGENTS.md`
  - custom assets not present in the scaffold, such as `assets/gradientRNBanner.png`
  - existing tracked image assets in `assets/`
  - `.expo-shared/assets.json` if it existed before
- Keep the fresh Expo Router entry setup.
- Reapply the cookbook-specific dependency set in `package.json` and `app.json`. Keep `app.json` pointing at the restored existing image assets unless changing them is intentional.

## Validation after regeneration

- Run these commands from inside the regenerated app directory:
  - `yarn expo install --check`
  - `yarn lint`
  - `yarn typecheck`
  - `yarn test --watchman=false`

## Lockfile guidance

- If the fresh scaffold causes dependency-resolution churn, restore the previous `yarn.lock` first and then run `yarn install` instead of re-resolving the full tree.