Skip to content

1.2.0

Choose a tag to compare

@SammiKliv SammiKliv released this 02 Jun 13:00
· 4 commits to main since this release

What's new

Theme Mode API

InsurelyConfiguration now accepts an optional themeMode parameter for controlling light, dark, and system-driven theme resolution:

InsurelyConfiguration(
    customerId: "...",
    configName: "...",
    themeMode: .system   // .light, .dark, or .system
)
  • .light or .dark — render the corresponding theme variant unconditionally.
  • .system — follow the host's color scheme via prefers-color-scheme. The embedded WKWebView inherits the host's trait collection so CSS media queries resolve correctly.
  • Omitted — the embedded WebView is forced to a light color scheme. This preserves the SDK's pre-1.2.0 behavior so existing integrations see no rendering change when upgrading.

Dark mode rendering requires your BlocksConfig to include at least one ConnectedTheme. With both light and dark identifiers configured, .system will follow the device automatically. Contact your Insurely account representative if you need help setting up ConnectedTheme rows.

Removed forced light color scheme

The embedded WKWebView no longer unconditionally overrides its color scheme to .light. This unblocks dark-mode rendering when themeMode is .system or .dark. For integrations that have not set themeMode, the forced-light behavior is preserved to maintain backward compatibility.

Backward compatibility

Existing integrations that do not set themeMode see no change in behavior. The JSON wire payload sent to blocks is unchanged when themeMode is nil, and the embedded WebView still renders light regardless of the host's color scheme.

Installation

Add via Swift Package Manager:

git@github.com:insurely/insurely-sdk-ios-distribution.git

Use the Exact Version rule for 1.2.0, or Up to Next Major Version from 1.2.0 to receive non-breaking updates automatically.

Assets

  • InsurelySDK.xcframework.zip — the signed binary framework for manual integration (not needed if you use Swift Package Manager).
  • InsurelySDK.doccarchive.zip — Xcode documentation bundle. Download, unzip, double-click to add to Xcode's documentation browser.