You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+46Lines changed: 46 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,6 +54,52 @@ The project uses `yarn` for dependency management and script execution.
54
54
-`examples/`: Example React Native applications using the library.
55
55
-`website/`: Documentation website.
56
56
57
+
## Example App Regeneration
58
+
59
+
- Prefer regenerating Expo example apps in a temporary directory and then copying the fresh scaffold into place, instead of mutating the existing app in place.
60
+
- Before replacing an example app, move the current app directory to `/tmp` so repo-specific code, tests, assets, and configs can be restored selectively.
61
+
- After copying a freshly generated app into `examples/`, remove the generated `.git` directory and generated `node_modules`, then reinstall from inside the repo workspace.
62
+
63
+
-`examples/basic`:
64
+
- Generate from the Expo blank TypeScript scaffold:
- Restore the repo-specific cookbook files on top of the new scaffold:
83
+
-`app/`
84
+
- tutorial test directories such as `basics-tutorial/` and `basics-tutorial-react-strict-dom/`
85
+
-`theme.ts`
86
+
-`jest.config.js`
87
+
-`jest-setup.ts`
88
+
-`babel.config.js`
89
+
-`.eslintrc`, `.eslintignore`
90
+
-`README.md`
91
+
- custom assets not present in the scaffold, such as `assets/gradientRNBanner.png`
92
+
-`.expo-shared/assets.json` if it existed before
93
+
- Keep the fresh Expo Router entry setup, then reapply the cookbook-specific dependency set in `package.json` and `app.json`.
94
+
95
+
- After regenerating either example app, validate from inside the app directory:
96
+
-`yarn expo install --check`
97
+
-`yarn lint`
98
+
-`yarn typecheck`
99
+
-`yarn test --watchman=false`
100
+
101
+
- If the fresh scaffold introduces dependency-resolution churn, prefer restoring the previous `yarn.lock` first and then running `yarn install`, rather than re-resolving the whole dependency tree from scratch.
102
+
57
103
## PR draft workflow:
58
104
59
105
- Maintain `PR.txt` at the repository root using the structure from `.github/pull_request_template.md`.
0 commit comments