Skip to content

Smoke Testing

  • Detect project from open FreeCAD documents on workbench activation
  • Refresh project detection and reload iterations
  • Display “No project detected” state when no repository found
  • Click project label to open repository directory in file browser
  • Initialize new git repository: choose directory from candidate list based on open documents
  • Initialize new git repository: directories already inside a project are disabled with explanation
  • Initialize new git repository: success message with initialized path and a new gitignore
  • Initialize new git repository: no candidates available when no saved documents open
  • Configure author name and email: save locally for current project only
  • Configure author name and email: save globally for all projects
  • Configure author name and email: global option disabled when global config file not writable, with explanation
  • Configure author name and email: name and email required field validation
  • Configure author name and email: pre-populated with existing identity values
  • Configure author name and email: cancel dialog aborts flow
  • View current gitignore content in editor dialog
  • Edit and save gitignore content
  • Cancel editor dialog without saving
  • Help link to gitignore syntax documentation
  • Display commit list with hash, author, timestamp, and message
  • Load more commits on scroll (infinite scroll / pagination)
  • Display “No iterations to display” placeholder when commit history is empty
  • Right-click commit: restore all files from iteration
  • Right-click commit: copy iteration ID (commit hash) to clipboard
  • Select Current Files Area row to show working tree diffs
  • Display document diff tree with status indicators (modified, added, deleted)
  • Display summary counts: Modified, Deleted, Added
  • Display “No changes” state when working tree is clean
  • Expand/collapse document nodes in diff tree
  • Diff row colors, hover, and selection remain visible with OpenTheme enabled
  • Existing diff rows update after switching between light and dark themes
  • Each document and node label renders once with OpenTheme enabled
  • Right-click Current Files Area: Mark All Files Reviewed works
  • Right-click Current Files Area: Discard All Changes works
  • Select Reviewed Area row to show staged diffs
  • Display staged document diff tree
  • Right-click Reviewed Area: remove all from Reviewed
  • Stage single document: plus icon button per document row with tooltip
  • Stage all documents: plus icon button in summary bar with tooltip
  • Remove single document from Reviewed: minus icon button per document row with removal tooltip; unstage document and snapshot without changing current files
  • Remove all from Reviewed: minus icon button in summary bar with removal tooltip; unstage documents and snapshots without changing current files
  • Stage button disabled for non-stageable documents
  • Stage deleted documents
  • Select node in document diff tree to show property-level differences
  • Property diff display with old/new value columns
  • Changed property colors remain visible while unchanged rows retain theme styling
  • Highlighted property values remain selectable and copyable
  • Property diff clears when document diff clears or node changes
  • Float precision from settings applied to numeric property display
  • Spreadsheet cells show raw input through expression display and aliases through Alias sub-paths; replacing a literal with a formula that evaluates to the same value appears as a change
  • Redundant spreadsheet literal expression rows stay hidden, including leading text apostrophes; formulas and source-input changes remain visible
  • Open 3D comparison for node from Current Files Area view
  • Open 3D comparison for node from Reviewed Area view
  • Open 3D comparison for node from commit view
  • Visual diff button per node row in diff tree
  • Current files area: discard single file and discard all works
  • Restore single document from commit: confirmation dialog with destructive warning
  • Restore all from commit: restore icon button opens scope selection dialog (listed FreeCAD files vs all FreeCAD files)
  • Restore confirmation: cancel aborts operation
  • Restore all: confirmation dialog after scope selection
  • Restore success info message
  • Restore failure error display
  • Save iteration: enter iteration notes dialog
  • Save iteration: empty notes validation warning
  • Save iteration: no reviewed files info message
  • Save iteration: missing git identity auto-prompts configure author dialog
  • Save iteration: commit success refreshes history list
  • Save iteration: commit failure error display
  • Save iteration: cancel dialog aborts flow
  • Right-click a document row in Current Files, Reviewed, or an iteration diff tree: Open current document opens the current file and switches from History to its document view, whether already open or closed
  • Failed opening from the closed-document indicator shows an error dialog without refreshing the diff or refocusing History
  • Open document for comparison: Open button on closed working-tree file indicator opens the file, refreshes the diff, and keeps History visible
  • Open all documents in repository
  • Open all documents in repository: no project warning
  • Recompute active document
  • Recompute all open documents
  • Close all comparison windows (Diff_* documents without saving)
  • Open History Panel from toolbar or command
  • Panel 3-column layout: history, document diff, property diff
  • Panel splitter resize between columns
  • Panel close and reopen preserves application state (current git repository detection)
  • With a TechDraw page tab open, open History from both the 3D tab and the page tab; only History occupies the active MDI page
  • Close and reopen History with the TechDraw page tab still open; History fills the active MDI page without exposing other subwindows
  • Panel focus after async FreeCAD actions (open document)
  • History activation preserves the active CAD document; Recompute Active Document still targets it
  • Enable Edit > Preferences > Display > UI > Overlay > Automatically hide in non-3D view; activating History auto-hides overlay panels and hovering over their edge hints does not reveal them
  • Clicking an overlay edge hint explicitly reveals its panel while History is active
  • Switching from History back to a 3D view restores the configured overlay behavior without changing dock preferences
  • Disable Automatically hide in non-3D view; History respects FreeCAD’s configured behavior without changing the preference
  • Detach and redock History through FreeCAD’s view controls; panel state remains available and Open History Panel focuses the same view
  • Float precision: set decimal places for numeric comparison (range 0-12)
  • Excluded object types: use default exclusion list
  • Excluded object types: use custom exclusion list with prefill from defaults on first use
  • Excluded properties: use default exclusion list
  • Excluded properties: use custom exclusion list with prefill from defaults on first use
  • Type-specific excluded properties: use default exclusion list
  • Type-specific excluded properties: use custom exclusion list with prefill from defaults on first use
  • Git executable: leave empty so git runs from the system PATH
  • Git executable: enter a path manually (e.g. portable git) and save; commit history loads through the configured binary
  • Git executable: Browse button opens a file dialog that fills the path field
  • Git executable: clear the field and save to return to PATH lookup
  • Git executable: popup “Git Not Found” when git is neither configured nor on PATH, or the configured path is not a readable executable (refresh project, initialize project, save iteration)
  • Git executable: no popup when detection simply finds no repository but git works
  • Settings save and load persistence
  • Settings info text: changes affect comparison only, not saved snapshots