Read the diagnostic
The attempted lookup shows repository, path, ref, and reason.
Example
taimoorq/newsfeedreader app/app/controllers/feeds_controller.rb main not foundIn that example, the doubled app/app path usually means the runtime path prefix or repository source root is adding app twice.
Fix order
Check the mapping before changing code.
- Open
Project > Settings > Integrations > Source repositories. - Confirm the repository is connected, not only synced.
- Click
Sync repositoriesif GitHub App access, repository selection, or permissions changed. - Set Runtime path prefix to the deployed prefix shown in stack frames, such as
/app. - Set Repository source root only for a real subfolder in the repo, such as
packages/api. Leave it blank when source files are at the repo root. - Confirm the default branch or event commit/ref contains the file.
Common symptoms
Most failures are mapping or ref mismatches.
| Message | Likely fix |
|---|---|
| No source repository mapping exists | Syncing is not enough. Connect a repository mapping for the project. |
| Mappings waiting for App access | Install or link the GitHub App installation, accept permission changes, then sync repositories. |
| File was not found | Check runtime path prefix, source root, default branch, and event commit/ref. |
| Wrong file or stale source | Send repository, commit_sha, and branch from the SDK or CI deployment record. |