Troubleshooting

Troubleshooting

The App Says The Folder Is Not A Git Repository

Open a folder inside a git working tree. Diff Drift uses git2 to discover the repo root from the selected path.

No Drift Detected

The working tree matches HEAD, or the current changes were reverted. Create or save an uncommitted change and wait for the watcher to update.

Changed Files But No Analyzed Files

Diff Drift only parses changed .ts and .tsx files. Other changed files can still count as changed git drift, but they will not appear as AST nodes.

A Flag Looks Wrong

Flags are heuristic prompts. Dismiss the flag if it is reviewed and not actionable. If it is noisy in a common code shape, open an issue or Discussion with:

• file type
• import or code pattern
• expected behavior
• screenshot or exported report if useful

Watcher Looks Stale

Save the file again or reopen the repo. Branch switches, resets, commits, and package metadata changes should trigger a rescan, but watcher behavior can vary by filesystem and editor.

Export Failed

Check that the chosen path is writable and not locked by another app. In native E2E, export can be controlled with DIFF_DRIFT_E2E_EXPORT_PATH.

Native App Will Not Build

Check the platform prerequisites:

• Rust stable installed.
• Node dependencies installed with npm install.
• Tauri prerequisites installed.
• On Windows, Microsoft C++ Build Tools and WebView2 are present.

Then run:

npm run build
npm run test:rust

If those pass but native build fails, include the Tauri error output in the issue.