# Troubleshooting

## Windows SmartScreen
If you see "Windows protected your PC", click:
**More info -> Run anyway**

This pilot executable does not yet have established Windows signing/reputation, causing SmartScreen to flag it.

## Installer does not launch
If the installer fails to launch entirely, please record:
- Your Windows version
- The exact error message
- A screenshot of the issue
- Your antivirus/security product (if relevant)

## Repository is not recognized
If Reality Gate fails to add your repository, please confirm that standard Git commands (e.g., `git status`) work inside that repository on your command line.

## Repository disappeared/moved
If you moved or deleted your repository from disk, Reality Gate may need the project to be re-added or re-resolved through the UI.

## App will not start
If Reality Gate refuses to start or crashes:
1. Capture any error messages or strange behavior.
2. Please do not delete your AppData folders unless explicitly requested, as preserving the failure state helps us debug.

## Reporting a bug
Please refer to `FEEDBACK.md` for information on how to provide bug reports and feedback.
