Release 4.3.3

Author: pspdfkit-ci

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 4.3.3 — 29 May 2026
+
+- Adds an Expo config plugin for Android that applies a theme to prevent `InvalidThemeException` in Expo managed apps. (J#HYB-995)
+
 ## 4.3.2 — 30 Apr 2026
 
 - Updated the `getConfiguration` API to return the current `toolbarPosition`. (J#HYB-991)

README.md

@@ -53,6 +53,41 @@ Nutrient.setLicenseKey('YOUR_REACT_NATIVE_LICENSE_KEY_GOES_HERE');
 
 To install the Nutrient React Native SDK, run `yarn add @nutrient-sdk/react-native` in your project directory or `npm install @nutrient-sdk/react-native` if you’re using `npm`.
 
+### Expo config plugin (Android)
+
+When using Expo prebuild/dev client, add the package as a plugin so Android `AppTheme` is switched to a MaterialComponents-compatible theme:
+
+```js
+// app.config.js
+export default {
+  expo: {
+    plugins: ['@nutrient-sdk/react-native'],
+  },
+};
+```
+
+The plugin defaults to an edge-to-edge-friendly DayNight parent (`@style/NutrientRN.AppTheme`). You can override it:
+
+```js
+// app.config.js
+export default {
+  expo: {
+    plugins: [
+      [
+        '@nutrient-sdk/react-native',
+        {
+          androidThemePreset: 'fullNutrient',
+          // or provide a fully custom parent:
+          // androidAppThemeParent: '@style/YourCustomTheme',
+        },
+      ],
+    ],
+  },
+};
+```
+
+After updating app config, run `npx expo prebuild -p android` (or rebuild with EAS).
+
 ### Getting Started
 
 See our [Getting Started on React Native guide](https://www.nutrient.io/getting-started/react-native/?react-native-platform=android-ios&project=new-project) to integrate the SDK into your new or existing application, or follow the steps below:

android/src/main/res/values/nutrient_rn_theme.xml

@@ -0,0 +1,14 @@
+<resources>
+    <!--
+      DayNight + MaterialComponents bridge app theme for Expo host activities.
+      This includes the required attributes validated by Nutrient theme checks.
+    -->
+    <style name="NutrientRN.AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar.Bridge">
+        <item name="colorPrimary">@color/pspdf__primaryLight</item>
+        <item name="colorPrimaryDark">@color/pspdf__onPrimaryContainerLight</item>
+        <item name="colorAccent">?colorPrimaryDark</item>
+        <item name="colorSecondary">@color/pspdf__primaryLight</item>
+        <item name="windowActionBar">false</item>
+        <item name="windowNoTitle">true</item>
+    </style>
+</resources>

app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./plugin');

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nutrient-sdk/react-native",
-  "version": "4.3.2",
+  "version": "4.3.3",
   "description": "Nutrient React Native SDK",
   "keywords": [
     "react native",
@@ -81,6 +81,8 @@
   },
 
   "files": [
+    "app.plugin.js",
+    "plugin/",
     "ios/",
     "android/",
     "lib/",

plugin/index.js

@@ -0,0 +1,10 @@
+const { createRunOncePlugin } = require('expo/config-plugins');
+const withNutrientAndroidTheme = require('./withNutrientAndroidTheme');
+const pkg = require('../package.json');
+
+const withNutrient = (config, props = {}) => {
+  config = withNutrientAndroidTheme(config, props);
+  return config;
+};
+
+module.exports = createRunOncePlugin(withNutrient, pkg.name, pkg.version);

plugin/withNutrientAndroidTheme.js

@@ -0,0 +1,52 @@
+const { withAndroidStyles } = require('expo/config-plugins');
+
+const THEME_PRESET = {
+  // DayNight + Bridge is the default because it is more robust with Expo edge-to-edge.
+  edgeToEdge: '@style/NutrientRN.AppTheme',
+  // Full Nutrient app theme for apps that want the SDK's complete default styling.
+  fullNutrient: '@style/PSPDFKit.Theme.Default',
+};
+
+function resolveThemeParent(props = {}) {
+  if (typeof props.androidAppThemeParent === 'string' && props.androidAppThemeParent.length > 0) {
+    return props.androidAppThemeParent;
+  }
+
+  if (props.androidThemePreset && THEME_PRESET[props.androidThemePreset]) {
+    return THEME_PRESET[props.androidThemePreset];
+  }
+
+  return THEME_PRESET.edgeToEdge;
+}
+
+function setAppThemeParent(styles, parent) {
+  const styleList = styles?.resources?.style;
+  if (!Array.isArray(styleList)) {
+    console.warn(
+      '[@nutrient-sdk/react-native] Could not find <resources><style> in Android styles.xml; AppTheme parent was not modified.'
+    );
+    return styles;
+  }
+
+  const appTheme = styleList.find((style) => style?.$?.name === 'AppTheme');
+  if (!appTheme || !appTheme.$) {
+    console.warn(
+      '[@nutrient-sdk/react-native] No <style name="AppTheme"> found in Android styles.xml; theme fix was not applied. Set `androidAppThemeParent` explicitly if your app uses a different theme name.'
+    );
+    return styles;
+  }
+
+  appTheme.$.parent = parent;
+  return styles;
+}
+
+const withNutrientAndroidTheme = (config, props = {}) => {
+  const themeParent = resolveThemeParent(props);
+
+  return withAndroidStyles(config, (config) => {
+    config.modResults = setAppThemeParent(config.modResults, themeParent);
+    return config;
+  });
+};
+
+module.exports = withNutrientAndroidTheme;

samples/Catalog/ios/Podfile.lock

@@ -9,7 +9,7 @@ PODS:
     - hermes-engine/Pre-built (= 0.14.0)
   - hermes-engine/Pre-built (0.14.0)
   - Instant (26.6.0)
-  - nutrient-sdk-react-native (4.3.2):
+  - nutrient-sdk-react-native (4.3.3):
     - boost
     - DoubleConversion
     - fast_float
@@ -2961,7 +2961,7 @@ SPEC CHECKSUMS:
   glog: 5683914934d5b6e4240e497e0f4a3b42d1854183
   hermes-engine: 949f245610ade3c3701f96b679119dee1869e1b5
   Instant: 95db4686c0be5e2953d8a80184ce4f239bcda5e5
-  nutrient-sdk-react-native: f4071354d6be77af130c79200d52a7c0be541757
+  nutrient-sdk-react-native: 483c4d9bf5b99dddff5cca2a33fbc7c304a1d6e0
   PSPDFKit: 8b63d55bf7df1947f9b20319703f7153550b81b3
   RCT-Folly: 59ec0ac1f2f39672a0c6e6cecdd39383b764646f
   RCTDeprecation: a41bbdd9af30bf2e5715796b313e44ec43eefff1

samples/Catalog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "catalog",
-  "version": "4.3.2",
+  "version": "4.3.3",
   "private": true,
   "scripts": {
     "android": "npx react-native run-android",