HTKapp Logo

Settings and Configuration

This guide shows you how to configure and personalize your experience in the HtkDoli app. The settings screen allows you to manage appearance options, behavior preferences, and security for your active session.

To access the settings, open the main menu and select the Settings section. Note that the settings described here apply globally or are isolated depending on the connected profile.

Appearance

This section allows you to modify the visual appearance of the application:

  • Theme: You can force Light, Dark mode, or let the application follow the theme of your System.
    • Business behavior: The modification is managed by the ThemeManager (ThemeManager.shared.userTheme) and is saved in your local preferences. The app will instantly adjust the overall colors according to the selected mode.

Preferences

The preferences section controls the application’s interaction with the system and data:

  • Haptic feedback: Activate or deactivate light vibrations of the phone during specific interactions (e.g. successful synchronization).
  • Notifications: Allows the application to send you system alerts via Apple’s notifications service (NotificationService). The first activation will ask for your system authorization.
  • Sync to Foreground: By enabling this option, the app will automatically initiate a synchronization when you open it or bring it to the foreground.
    • Business Behavior and Isolation: In order to guarantee strict security and confidentiality (HtkDoli multi-profile principle), this option is recorded in isolation for the active profile. HtkDoli stores this preference in UserDefaults by associating the unique UUID of your session (e.g. syncOnForegroundEnabled_{profile_UUID}). It will therefore not apply to your other Dolibarr accounts.

Security

The security of your current session can be enhanced locally on the device.

  • Code lock (PIN): You can protect access to this specific profile with a 4-digit code.
    • Business behavior: The code is managed by a dedicated protection service (PinProtectionService). If enabled, an unlock screen will appear every time the profile is reopened. If you decide to disable the code, the application will immediately delete the secure key associated with this profile (pinProtectionService.removePin(for: profile.id)).

About

This section displays technical information about the application:

  • Version: The public version of the application (e.g. 1.0).
  • Build: The build number of the application. This information is useful for technical support or when reporting bugs.