Skip to content

Settings Reference

The Settings dialog in TrueFidelity Desktop provides configuration options to customize your experience. Access it through File → Settings or the settings icon in the toolbar.

Current Settings

The Settings dialog is organized into categories, with most features planned for future releases. Currently, only basic confirmation settings are functional.

Settings Categories

The settings are organized in a tree structure on the left side of the dialog:

  • Appearance - Visual customization options
  • Editor - Editor behavior and features
  • Confirmations - Control when confirmation dialogs appear
  • Advanced - Advanced configuration options

Available Settings

Confirmations

The Confirmations section controls when the application asks for your confirmation before performing actions.

Show Delete Confirmations

Setting: Show delete confirmations - Default: Enabled (checked) - Description: When enabled, the application will ask for confirmation before deleting any element including: - Diagrams from the system - ECUs from the canvas - Networks from the canvas - Switches and other network elements - Connections between elements

How it works: - When enabled, a confirmation dialog appears before any delete operation - Each confirmation dialog includes a "Don't show this again" checkbox - Checking "Don't show this again" temporarily disables confirmations for that session - The setting persists between application restarts

Best practice: Keep this enabled to prevent accidental deletion of system components, especially when working with complex network topologies.

Settings Under Development

The following sections are visible in the Settings dialog but are not yet functional:

Appearance (Coming Soon)

Planned appearance customization options:

  • Theme:
  • Dark (Default) - Currently the only available theme
  • Light (Coming Soon)

  • High Contrast (Coming Soon)

  • Font Size:

  • Small
  • Medium (Default)
  • Large

Editor (Coming Soon)

This section will contain editor-related settings in future updates. Currently displays a placeholder message.

Advanced (Coming Soon)

This section will contain advanced configuration options in future updates. Currently displays a placeholder message.

Settings Management

Automatic Saving

All settings changes are saved automatically. There is no need to manually save or apply changes. The status "Changes are saved automatically" appears at the bottom of the dialog.

Reset to Defaults

You can reset all settings to their default values:

  1. Click Reset to Defaults button at the bottom left of the Settings dialog
  2. Confirm the action in the confirmation dialog
  3. All settings return to their original values

Warning: Resetting to defaults cannot be undone.

Settings Persistence

Settings are stored locally using browser storage mechanisms and persist between application sessions. The settings are stored under the key truefidelity-settings.

Keyboard Shortcuts

While the Settings dialog is open: - Escape - Close the dialog (same as clicking Close) - Tab - Navigate between settings - Space - Toggle checkboxes

Tips for Using Settings

For New Users

  1. Keep confirmations enabled initially to avoid accidental deletions
  2. Once familiar with the interface, you can disable confirmations if desired
  3. Settings changes take effect immediately - no restart required

For Teams

  1. Document your team's preferred settings configuration
  2. Communicate any changes to confirmation settings
  3. Consider keeping delete confirmations enabled for shared projects

Troubleshooting

If settings don't persist: 1. Check that browser storage is not disabled 2. Ensure the application has write permissions 3. Try resetting to defaults if settings become corrupted

Future Enhancements

The Settings dialog is designed to be extensible. Future updates may include:

  • Additional theme options and visual customization
  • Editor preferences and behavior settings
  • Keyboard shortcut customization
  • Performance tuning options
  • Import/export settings profiles
  • Team synchronization features

Check release notes for new settings as they become available.

Platform-Specific Notes

Windows

Settings are stored in the user's local application data folder.

macOS

Settings are stored in the application's preferences directory.

Linux

Settings are stored in the user's config directory following XDG specifications.

  • Getting Started - Initial setup and configuration
  • UI Tour - Understanding the interface elements
  • FAQ - Keyboard shortcuts and common questions
  • Troubleshooting - Common issues and solutions

Summary

The current Settings implementation focuses on essential functionality with a single configurable option for delete confirmations. The interface is designed for future expansion, with placeholder sections indicating upcoming features. All changes save automatically, and you can reset to defaults at any time.

As TrueFidelity Desktop evolves, additional settings will be added to provide greater customization and control over your workflow.