Troubleshooting

Viewing logs

In the app — Logs tab

Switch to the Logs tab to see all application activity in real time. The toolbar lets you:

• Filter by severity (Debug, Info, Warning, Error)
• Search log text with Ctrl+F
• Change verbosity (Minimal → Diagnostic)
• Open Folder — opens the log file directory in Windows Explorer
• Export Log — saves the current log to a .txt or .csv file

Log files on disk

Log files are written automatically to:

Files rotate daily and the 7 most recent are kept. The quickest way to open the folder is the Open Folder button in the Logs tab.

To capture Debug-level messages (useful when diagnosing a specific issue), enable Settings → Performance → Debug Logging before reproducing the problem.

Common issues

Output SVG looks wrong (missing elements, clipped content, wrong colours)

1. Try a different input profile. Use Auto-detect if unsure.
2. Open in Preview & Compare for a side-by-side comparison.
3. If elements are clipped, try the Generic CGM profile — the file may have an unusual VDC extent.
4. If colours are wrong, the file may use indexed colour — try PIP (petroleum) or Generic CGM.

Hotspots are missing from the output

• Confirm the source CGM contains Application Structures using the Validation tab.
• Ensure the correct input profile is selected — Generic CGM strips hotspot metadata.
• Check Settings > SVG Options > Hotspot encoding is not set to produce no output.

Preview & Compare tab is blank

Requires WebView2. See Installing WebView2.

“Licence error” (exit code 10) from the CLI

• Run reforge license status to check the licence state.
• Ensure the licence includes CLI access (Professional or Enterprise).
• Re-activate if the licence file is missing: reforge license activate.

SmartScreen blocks the installer

Click More info then Run anyway. See SmartScreen warning.

Application crashes on startup

1. Check %LocalAppData%\Reforge\Logs\ for the latest crash log.
2. If the log mentions WebView2, install it from the WebView2 download page.
3. If the log mentions .NET, run the .NET 9.0 installer from dot.net.

Reporting an issue

1. Note the input profile and output format used.
2. Note the Reforge version from Help > About.
3. Collect the latest crash log from %LocalAppData%\Reforge\Logs\.
4. Email support@reforgesoftware.com with the above.