RazorCAD
Chapters

User manual / Troubleshooting

Troubleshooting

Crash reports

RazorCAD writes a crash report whenever something goes wrong, to %APPDATA%\RazorCAD\crashes\<date_time>_<kind>\. Open the folder with Help ▸ Open Crash Reports Folder. The start window mentions new reports. The newest 30 are kept.

FileContents
report.jsonThe kind of failure, the error message and stack trace, what RazorCAD was doing (mode, Property panel, sketch tool, selection, feature errors) and system information
session.logThe recent actions of the session, newest last
part.rcadThe part that was open, so the problem can be reproduced

Kinds of report: ui-error, kernel-error, kernel-worker-crash, python-exception, native-crash and unexpected-shutdown (a session that ended without closing normally, found at the next launch).

Common problems

ProblemWhat to do
A fillet or projected edge loses its edge after a big changeEdges are found again by their geometry and the faces beside them (see References that follow edits). If one is still lost, Tools ▸ Fix References lists it: Edit to re-pick it, or Remove missing.
A mate moved to the wrong face, or shows a red !Mates find their faces again by geometry. A face that is gone is listed in Tools ▸ Fix Mates: edit the mate to pick it again.
A sketch on a model face doesn't follow the faceSketches on faces are stored as fixed planes. Use a reference plane driven by an equation when that matters.
Project Edges can't see a sketchIt only sees visible sketches earlier in the history. Show the sketch first.
An STL body can't be filletedSTL bodies with thousands of faces can't be filleted or chamfered and don't offer pickable edges.
A fillet won't blend across two touching bodiesCombine the bodies first.
Open fails with a file filter errorFixed in 0.9.0-beta. Update RazorCAD.
Unsaved work after a crashReopen the part and accept the auto-save recovery.

Settings and data files

LocationContents
%APPDATA%\RazorCAD\recent.jsonRecent files list
%APPDATA%\RazorCAD\claude.jsonClaude settings, API key and model
%APPDATA%\RazorCAD\prefs.jsonToolbar layout, icon size, your keyboard shortcuts, whether the tour was taken, and other preferences
%APPDATA%\RazorCAD\update.jsonThe update check: on or off, when it last looked, a version you chose to skip
%APPDATA%\RazorCAD\crashes\Crash reports
%LOCALAPPDATA%\RazorCAD\modelcache\Built models of parts and assemblies, and the geometry after each feature, for fast opening and editing (up to 1 GB; safe to delete)
Documents\RazorCAD\Templates\Your drawing templates
Name.autosave.rcadAuto-save, next to the part file