Stable Templafy Desktop Client

This article contains release notes for the Stable release plan on Templafy.

Technical information

Release Notes

3.10.9 - March 25, 2025

Features

• Install lefthook in Desktop: This release replaces husky with lefthook to manage git pre-commit hook and run lint when staged files include certain file extensions.
• Upgrade Desktop to eslint 9: We have successfully upgraded the Client.UI to ESLint 9, enhancing code quality and consistency across the project.

3.9.33 - February 11, 2025

Features

• Desktop: Use CodeQuality package and adjust .editorconfig: Use Templafy.CodeQuality package and adjust .editorconfig.

3.9.2 - January 14, 2025

• This version focuses on improving performance, without any updates to product features or bug fixes.

3.9.0 - November 5, 2024

• This version focuses on improving performance, without any updates to product features or bug fixes.

3.8.55 - July 2, 2024

• This version focuses on improving performance, without any updates to product features or bug fixes.

3.8.53 - June 18, 2024

Features

• Desktop: Synchronize sources and translations from Crowdin: Pulled new translation and source string from Crowdin.
• Announce that visiting the knowledge base will open in new window: Screen readers now announce that a new window will open when clicking the visit knowledge base button in the troubleshooting tab.
• Make version numbers in Templafy Desktop not be read as dates: The version numbers under the modules tab are now read by screen readers as numbers instead of dates.
• Announce that clicking the Visit Templafy button will open a new window: Announce that clicking the Visit Templafy button will open a new window.
• Update the window title for authentication for templafy desktop: Removed accessibile name from templafy desktop window so that it does not get announced twice by screen readers.
• Change the aria-describedby with aria-label: Changed the aria-describedby to aria-label to make both NVDA and JAWS works nicely.

Bugs

• The WebView2Loader in the latest Templafy Desktop Client doesn't work with Host 2.2: Copying the 64-bit version of the WebView2Loader dll to the temp folder if running a 64-bit process.
• Templafy Desktop installer doesn't remove the RunOnce key left from previous uninstaller: Removed the cleanup leftover files script from the RunOnce on the Templafy Desktop start to prevent deleting files when the user installed the Templafy Desktop back without restarting the machine.
• Deleting outdated clients is broken in the Templafy Desktop: Fixed bug in WebView2 where WebView2Loader.dll remained locked after upgrading the Client, preventing the old Client folders to be deleted.

3.8.39 - May 21, 2024

Features

• Fix announcement of main Templafy Desktop window: Fixed issue where Templafy desktop's title was being announced twice by screen readers.
• Show log in both Modules and Troubleshooting pages buttons should announce it opens in another window: Added accessibility announcement to let user know that when clicking on view logs that the logs open in a new window.
• Change Show log files in Troubleshooting to announce Show Templafy Desktop log files: Announce Templafy desktop logs on the show log file button in the troubleshooting tab.
• Desktop: Synchronize sources and translations from Crowdin: Pulled new translation and source string from Crowdin.
• Fix notifications work in JAWS: Notifications in the Templafy Desktop are made accessible and announced correctly in JAWS and NVDA. We also changed slightly the behavior of notifications. The notifications are now always shown, when the notifications checkbox is enabled. They will show, even when the updates started automatically in the background. 
• In the tab modules the Module name and version are read together: The module name and version are now read as two separate fields by the screen reader.
• Fix navigation and announcements in JAWS: Fix the arrow and tab navigation as well of the announcements in both NVDA and JAWS.
• Fix tabs navigation for JAWS: Fixed tabs navigation for JAWS and simplify code for app tsx.

Bugs

• The window of the Templafy Desktop is not always visible after updating client: Templafy Desktop: Made Templafy Desktop always visible after updating the client.

3.8.20 - May 7, 2024

Features

• Make notifications be announced by screen reader: Templafy Desktop: Made the Notifications of Templafy Desktop to be accessible.
• When update client starts the update box should be announced: Templafy Desktop: Announce with screen reader the 'Upgrade required' message.

3.8.11 - April 25, 2024

Features

• Fix page titles announcements: Fixed screen reader announcements of page titles in Desktop.
• Desktop window should be focused when started from start menu and announced by screen reader: Fixed Desktop window focus when started second time.
• Announce Authentication UI when it is opened and make it accessible: The authentication window is now focus automatically after pressing login to make it accessible

3.8.2 - April 9, 2024

Features

• Fix the Templafy Desktop accessibility issues related to React frontend: Fix the Templafy Desktop accessibility issues related to React frontend.
• Desktop: Synchronize sources and translations from Crowdin: Pulled new translation and source string from Crowdin.
• Check and add accessibility to Templafy Desktop ClientUI: Add accessibility to Templafy Desktop ClientUI and reorganize frontend structure.

Bugs

• Templafy Desktop UI crashes if pressing F5: Fixed the bug where pressing F5 caused the Desktop Client UI to crash.
• CheckForUpdates button doesn't change the state immediately to "Updating..." when clicked: Fix the issue where the CheckForUpdates button does not immediately change its state to 'Updating' upon being clicked.

3.7.10 - January 16, 2024

Features

• Fix the Templafy Desktop Autostart behavior to make the UI appear when it's not autostart: The behavior of the autostart parameter has been fixed.
• Onboard system repos: Adding code-owners.yml for automated branch policy management.
• Show Desktop window when an error is thrown: Show Templafy Desktop window when an error is thrown during Update or Authenticate process.
• Only show Desktop window on demand: Templafy Desktop: Only show Desktop window on demand.

3.7.3 - December 5, 2023

• This version focuses on improving performance, without any updates to product features or bug fixes.

3.7.2 - October 24, 2023

• This version focuses on improving performance, without any updates to product features or bug fixes.

3.7.1 - September 12, 2023

• This version focuses on improving performance, without any updates to product features or bug fixes.

3.7.0 - August 29, 2023

• This version focuses on improving performance, without any updates to product features or bug fixes.

3.6.1 - July 5, 2023

Bugs

• Polish OS language causes Templafy Desktop to crash: Polish OS language causes Templafy Desktop to crash.

3.5.26 - June 2023

• Templafy Desktop permanent exception after unsuccessful package update: Resolve an issue where a mismatched package list resulted in a permanent exception.

3.5.19 - June 2023

• Manage certificate with variable group: Code signing certificate is managed within a variable group.
• Fix build for Client project of Templafy Desktop solution: Create the Client.UI\build folder before creating the Zip'ed file
• Make LocalizationService to be ICU-compatible: Make LocalizationService to be ICU-compatible and updated crowdin.yml
• Introduce crowdin in Templafy Desktop: Implemented Crowdin support for the automated translations.
• Enable correct WebView2 debug settings: Enabled correct WebView2 debug settings to be able to spy elements in Ranorex.

3.5.13 - May 2023

• Change certificate for Desktop: Code signing certificate is updated in the pipelines.
• Minor refactoring and cleanup: Minor code refactoring and cleanup on the Desktop.Host. Those changes are safe and do not affect any logic.
• Modules.xml are not always saved before the Add-ins: The configuration package containing the Modules.xml file is now always processed as the first file to avoid that Add-Ins will have a wrong configuration after an update.

3.5.10 - April 2023

• Templafy Desktop does not update when Tenant has 'Automatic Login' setting disabled: This release fixes the issue where Templafy Desktop Client would not be able to fetch new updates when the tenant has disabled the 'Automatic Login' setting and the Templafy Desktop refresh token has expired.
• Templafy Desktop and applications are not recovering correctly from a sign-out or otherwise invalid refresh token in registry: Fixed the bug that happens due to Templafy Desktop tried to send the authentication requests with existing token while the authentication token has already been invalidated on the server.

3.5.2 - March 2023

• Security audit: DLL Hijacking: This release ensures Templafy Desktop Host and Templafy Desktop Client will only load external assemblies from Windows System32 directory. This prevents potential DLL hijacking.
• Users in Templafy Desktop have to sign-in when shown the onboarding page: This release skips unnecessary call to reauthenticate for users who are shown the onboarding page.

3.4.77 - March 2023

• Templafy Desktop plugin logging failing when passing exceptions: This is an internal technical release with no user-facing changes. This version gives better support for Templafy Desktop plugin exception logging. Users in Templafy Desktop have to sign-in when shown the onboarding page.
  

3.4.76 - January 2023

• Review code smells and hotspots for desktop: This is an internal technical release with no user-facing changes. Some code smells were fixed.

3.4.75 - January 2023 

• Register the new token in the registry Computer\HKEY_CURRENT_USER\SOFTWARE\Templafy\Desktop: With this release Templafy Desktop can remain logged in after the add-in refresh token expires and will only require re-authentication after 30 days.

3.4.74 - January 2023

• Antiforgery validation failing for downloading offline content in Templafy Desktop: This release fixes intermittent failing requests made by Templafy Desktop plugins. The reason requests were failing is because in edge cases the wrong header values were passed along the requests which caused antiforgery validation to deny the requests.

3.4.73 - December 2022

• Templafy Desktop front-end tracking is not enriching the tracking data with client info: This release fixes a problem with enriching some of the tracking data with client specific information. This release has no user-facing changes.
• Add support for tracing in Templafy Desktop and Office Add-ins tracking events: This release improves tracking and tracing in Templafy Desktop. This release has no user-facing changes.

3.4.70 - November 2022

• Downgrade to a previously installed version of Templafy Desktop Client causes error: This release updates the outdated client's version cleanup process to rename the version folder, allowing reinstalling a previously installed Templafy Desktop client version multiple times.

3.4.68 - October 2022

• Error accessing plugin-files.json during update in Templafy Desktop: This release avoids occasional concurrency issues with requests from plugins. This problem manifested in the offline content plugin and resulted in some offline content not being downloaded as well as potentially downloading files that would not be removed during uninstall of Templafy Desktop.

3.4.65 - September 2022

• Ensure Templafy Desktop uninstall blocked files dialog appear on top of all windows: This release configures the Templafy Desktop uninstall blocked files dialog to appear as the top-most window.
• Use startup arguments to temporary disable upgrade of Templafy Desktop Client: This is a technical change in how we prevent infinite restarts of Templafy Desktop Client when the Client requires an update, but the Host is unable to install this update.
• Templafy Desktop throws a NullReference exception on Check for updates when the plugin-files.json file has an invalid content: This release fixes a NullReference exception caused by invalid content of the plugin-files.json file.

3.4.58 - August 2022

• Remove pre-requisite check for Tools for Office (vsto runtime) and WebView2: This is an internal technical release in preparation for the new Host 3.1 version with no user-facing changes that removes VSTO runtime and WebView2 from pre-requisites when installing Templafy Desktop. 
• Templafy Desktop does not respect DNS changes: This is an internal technical release in preparation for the new Host 3.1 version with no user-facing changes. In that release, we made Templafy Desktop Host respects changes in DNS. 
• Investigate and code sign the executable: This is an internal technical release in preparation for the new Host 3.1 version with no user-facing changes. This release entails changing the pipeline to sign the host executable.
• The plugin tracking service does not track the files deletion when directory is deleted: This is an internal technical release when we improve the cleanup process when uninstalling Templafy Desktop plugins to reduce the number of warnings in a log file.
• Templafy Desktop does not translate CurrentUser when the value starts with extra quotes: This release adds the support of scanning the entire value of the registry key for the folder translation. Before that, Templafy Desktop translated only keys that started from certain values e.g. C:\Users\CurrentUser or C:\ProgramData. And that sometimes caused an issue when a registry key has a value with, for example, a leading quote or backslash.
• Two parallel instances of Templafy Desktop cause error: This release fixes the issue where it was possible to trigger a second update process when the user was already authenticated when Templafy Desktop is started.
• Provide SDK for plugins to download within a download slot: This release facilitates Templafy Desktop plugins to use download slots.
• Add translations to Templafy Desktop notifications: Added the English translation file for the notifications that are shown by Templafy Desktop.

3.4.51 - August 2022

• Remove DisableDesktopClientUpgrade flag on the first check for updates: This release improves Templafy Desktop Client behaviour when the host has disabled the client upgrade. The client now removes the registry flag when it checks for available package updates. That allows the client to receive an upgrade when it checks for packages update next time.
• Templafy Desktop doesn't load into Overview tab: This release fixes the issue where Templafy Desktop Client UI stalls with the Templafy splash screen when the user uses language, we don't support translations for.
• Check for updates button in Templafy Desktop 'Overview' tab continues spinning while plugins are running: We are now disabling the check for updates button on the Overview tab when modules are updating instead of showing a spinner.
• Update spinner is gone when installing packages in Templafy Desktop: This release fixes the state of the "Check for updates" button to show the spinner when an update either of Add-ins or modules is still in progress.
• Investigate if we can bundle uninstaller again: This release bundles Templafy Desktop Client Uninstaller to one file as we had before the plugin's functionality was introduced.
• When checking for updates without previous run 'Overview' tab does not update status until after plugins run: This release fixes the issue where the 'Overview' tab wouldn't update the package update status only until after the plugins processing finished on a new installation of Templafy Desktop.
• Templafy Desktop UI does not update status until plugins are finished processing: This release fixes the issue where the 'Overview' tab's 'Last updated' status would not be updated only until after the plugin's processing has run, potentially temporarily showing incorrect status after the packages have been downloaded.
• Plugins from Templafy Desktop are not using TLS 1.2: This is a technical release with no user-facing changes that defaults the plugins' TLS configuration to TLS1.2.
• Show a dialog for locked files during manual Templafy Desktop uninstall: This release adds a Retry/Ignore dialog to show to the user when Microsoft Office applications are blocking the uninstallation process, also adds support for silent uninstallation with /qn and /quiet arguments to prevent user interaction with the uninstallation.
• Update README.MD files in Templafy Desktop: Updated and reviewed the internal readme file for Templafy Desktop.
• Update Client.UI to new state management library: This is a technical release that contains the replacement of Redux to Zustand as the state management library in the Templafy Desktop client application. This release contains no user-facing changes.
• Update TemplafyDesktop to support the new add-in: Add Corporate Terminology to the list of modules in Templafy Desktop.

3.4.38 - July 2022

• The templafy desktop plugin does not delete the plugin-files.json file when being uninstalled: Fixed a bug, that lead to the previous Addin folder version not being deleted in the case a plugin was used by the Addin

3.4.30 - July 2022

• Templafy Desktop doesn't apply/create all the registry keys specified in the .reg file: This release contains a fix for opening a RegistryView when Templafy Desktop applies changes for the Registry. Before that fix, Templafy Desktop used to open a 64-bit representation of the Registry when accessing keys in HKLM and a 32-bit representation when accessing all other keys as Templafy Desktop always runs as a 32-bit process. In this fix, we take into account the bitness of a user's machine and open a RedistryView that corresponds to that bitness.
• Change timestamp server for Templafy Desktop Host pipeline: This is an internal technical release with no user-facing changes.

3.4.27 - June 2022

• Unhandled exceptions from plugin should be displayed correctly in the Templafy.Desktop log: Implemented correct handling of unhandled exception that can happen in the plugin, so that the user see the necessary information in the log.
• Use Translator in Templafy.Desktop UI: This release contains adding translation support to Templafy Desktop and using it instead of hard-coded texts.
• Templafy Desktop settings UI in ServerMode is not responsive: This release fixes an issue with Templafy Desktop buttons in the UI not working in servermode.
• .NET Framework version lookup: Templafy desktop client only looked in the 64bit registry when looking for the .NET Framework version. This release ensures we are looking up the version of the dot net framework both in the root path and in the WOW6432Node part of the registry.
• Enable Nullable Reference Types in Templafy Desktop: This is a technical release to enable nullable reference types in our code.
• Disable Login in Templafy Desktop: This release allows disabling the automatic login process (without user interaction) in Templafy Desktop by means of the registry string value DisableAutomaticLogin under the registry key HKEY_CURRENT_USER\SOFTWARE\Templafy\Desktop. In order to disable the automatic login, the registry value should be set to "true".
• Use http headers to send Templafy Desktop tracking instead of passing the values through the query string: This is an internal technical release with no user-facing changes.

3.4.12 - April 2022

• Set of internal technical releases with no user facing changes: This version contains upgraded from Azure DevOps API version 5.1 preview 1 to version 5.1, removal of obsolete code in Templafy Desktop and fixes withing SonarCloud project.

3.4.7 - March 2022

• Add unit test for TrackingUploader: Technical release that adds unit test for Tracking Uploader to Templafy Desktop. This release does not introduce any user facing changes.
• Implement plugin support in Templafy Desktop: Templafy Desktop now supports the post update runner plugin. To use it, create a .NET Framework class library project in your add-in and make sure the result dll and its dependencies is shipped in the Addin/TemplafyDesktopPlugins folder.
• Verify the plugin dlls are signed: Before loading the plugin Templafy Desktop is now verifying that the plugin DLLs are correctly signed.
• Design for 'upgrade required' incorrect on Templafy Desktop: Version 3.4.0 introduced an update of the Templafy Desktop UI. As a side effect the alignment of the "upgrade required message" was incorrect. This release fixes that problem.
• Fix ClientCertificateRequested in Templafy Desktop: This release ensures the WebView2 browser will automatically pick the certificate if only one certificate is available when the site requests a certificate from the browser.
  • Why: Templafy Desktop previously did not support an event in WebView2 that would query the respective certificate on behalf of the user and therefore prevent the certificate selection dialog prompt.
  • How: By handling the respective event in WebView2, login can succeed without user's interaction (quietly).

3.3.2 - February 2022

• Templafy Desktop uninstaller throwing exception for missing assembly System.IO.Abstractions: This release fixes a problem with Templafy Desktop Uninstaller not removing all installed files. The installer would exit and log an exception about missing assemblies.

3.3.0 - December 2021

• Introduce retry mechanism in seamless SSO flow in Templafy Desktop: This release adds a resilience mechanism to Templafy Desktop's SSO login flow by retrying the SSO login request in case of failure. This feature has been added in the attempt to address issues that have been reported in different tenants, where some of their users would be presented with the 'Access Templafy' login dialog due to SSO login failure. The tenants that reported the issue, would in most cases have some network infrastructure component (VPN, DNS proxies, ...) that could impact network access during user session startup which can consequentially impact the SSO operation. The number of retry attempts (defaults to 5) and the interval between retry attempts (defaults to 2 minutes) used in the retry mechanism are configurable under the registry key HKEY_CURRENT_USER\SOFTWARE\Templafy\Desktop with the following entries: AuthenticationFailureRetryAttempts: Integer - the number of retry attempts AuthenticationFailureRetryInterval: Integer - the number of minutes between retry attempts. Please note that these keys are not automatically created and have to be added manually in order to change the default settings.
• Serialization issue in Templafy Desktop logs: This release fixes an issue with returning incorrect response messages on unauthenticated requests.
• Add workaround for issue related to WebView2 runtime in Hive: Added workaround for WebView 2 95.x runtime issue as suggested by Microsoft.