Skip to content

add troubleshooting about metro Invariant Violation #348

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
radoslawrolka wants to merge 2 commits into
base: main
Choose a base branch
from
Open

add troubleshooting about metro Invariant Violation #348

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0478190
add troubleshooting about metro Invariant Violation
radoslawrolka May 21, 2026
9f3accb
remove excluding from metro snippets
radoslawrolka May 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions TROUBLESHOOTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -276,4 +276,26 @@ To fix this, you need to exclude the `.rnrepo-cache` directories from Expo's fin

See the [`.fingerprintignore` documentation](https://docs.expo.dev/versions/latest/sdk/fingerprint/#fingerprintignore) or [`fingerprint.config.js` documentation](https://docs.expo.dev/versions/latest/sdk/fingerprint/#fingerprintconfigjs) for more details.

### Metro `Invariant Violation` for `.rnrepo-cache` Directory

#### Problem Description
After running `pod install`, Metro may crash with an `Invariant Violation` error when it detects a change inside the `.rnrepo-cache` directory created by the RNRepo plugin:

```
Invariant Violation: Detected addition or modification of file node_modules/react-native-screens/.rnrepo-cache/Current, but it is tracked as a non-empty directory
...
```

This happens because Metro's `TreeFS` initially sees `.rnrepo-cache/Current` as a directory (it is an Xcode-style symlink pointing to the currently active xcframework version) and then receives a filesystem event that treats it as a file. The mismatch causes Metro to throw.

#### Solution
Cleaning metro/watchman cache usually helps:

```bash
npx watchman watch-del-all
npx metro restart --reset-cache # or for expo: npx expo start -c
```

But if issue still persist, you can exclude the `.rnrepo-cache` directories from Metro's file watcher by adding them to the `blockList` in your `metro.config.js`:

---
Loading