1.2.0
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
).lightor.dark— render the corresponding theme variant unconditionally..system— follow the host's color scheme viaprefers-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.