expo-widgets 56.0.13 → 56.0.15

package/CHANGELOG.md

@@ -10,6 +10,22 @@
 
 ### 💡 Others
 
+## 56.0.15 — 2026-05-26
+
+### 🎉 New features
+
+- [Android] Create base android package. ([#46090](https://github.com/expo/expo/pull/46090) by [@jakex7](https://github.com/jakex7))
+- [plugin] Create config plugin for android. ([#46091](https://github.com/expo/expo/pull/46091) by [@jakex7](https://github.com/jakex7))
+
+### 🐛 Bug fixes
+
+- Allow string widget family values in the typed config plugin. ([#46133](https://github.com/expo/expo/issues/46133) by [@eliotgevers](https://github.com/eliotgevers))
+- [plugin] Inherit `ios.deploymentTarget` from app config for generated widget extension targets. ([#46193](https://github.com/expo/expo/pull/46193) by [@eliotgevers](https://github.com/eliotgevers))
+
+## 56.0.14 — 2026-05-23
+
+_This version does not introduce any user-facing changes._
+
 ## 56.0.13 — 2026-05-21
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -0,0 +1,38 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+  dependencies {
+    classpath("org.jetbrains.kotlin.plugin.compose:org.jetbrains.kotlin.plugin.compose.gradle.plugin:${kotlinVersion}")
+  }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'expo-module-gradle-plugin'
+apply plugin: 'org.jetbrains.kotlin.plugin.compose'
+
+group = 'expo.modules.widgets'
+version = '56.0.15'
+
+expoModule {
+  canBePublished false
+}
+
+android {
+  namespace "expo.modules.widgets"
+  defaultConfig {
+    versionCode 1
+    versionName '56.0.15'
+  }
+
+  buildFeatures {
+    prefab true
+    compose true
+  }
+}
+
+dependencies {
+  api 'androidx.glance:glance:1.2.0-rc01'
+  api 'androidx.glance:glance-appwidget:1.2.0-rc01'
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest>
+</manifest>

package/android/src/main/java/expo/modules/widgets/ExpoWidgetsAppWidgetProvider.kt

@@ -0,0 +1,10 @@
+package expo.modules.widgets
+
+import androidx.glance.appwidget.GlanceAppWidget
+import androidx.glance.appwidget.GlanceAppWidgetReceiver
+
+open class ExpoWidgetsAppWidgetProvider(
+  private val widgetName: String
+) : GlanceAppWidgetReceiver() {
+  override val glanceAppWidget: GlanceAppWidget = ExpoWidgetsGlanceWidget(widgetName)
+}

package/android/src/main/java/expo/modules/widgets/ExpoWidgetsGlanceWidget.kt

@@ -0,0 +1,17 @@
+package expo.modules.widgets
+
+import android.content.Context
+import androidx.glance.GlanceId
+import androidx.glance.appwidget.GlanceAppWidget
+import androidx.glance.appwidget.provideContent
+import androidx.glance.text.Text
+
+internal class ExpoWidgetsGlanceWidget(
+  private val widgetName: String
+) : GlanceAppWidget() {
+  override suspend fun provideGlance(context: Context, id: GlanceId) {
+    provideContent {
+      Text(widgetName)
+    }
+  }
+}

package/android/src/main/java/expo/modules/widgets/WidgetsModule.kt

@@ -0,0 +1,10 @@
+package expo.modules.widgets
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class WidgetsModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("ExpoWidgets")
+  }
+}

package/expo-module.config.json

@@ -1,6 +1,9 @@
 {
-  "platforms": ["apple"],
+  "platforms": ["apple", "android"],
   "apple": {
     "modules": ["WidgetsModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.widgets.WidgetsModule"]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-widgets",
-  "version": "56.0.13",
+  "version": "56.0.15",
   "description": "Widgets.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -22,7 +22,7 @@
   "homepage": "https://docs.expo.dev/versions/latest/sdk/widgets/",
   "dependencies": {
     "@expo/plist": "^0.7.0",
-    "@expo/ui": "~56.0.12"
+    "@expo/ui": "~56.0.14"
   },
   "devDependencies": {
     "@expo/spawn-async": "^1.8.0",
@@ -30,8 +30,8 @@
     "@types/react": "~19.2.0",
     "react-native": "0.85.3",
     "resolve-workspace-root": "^2.0.0",
-    "expo": "56.0.3",
-    "expo-module-scripts": "56.0.2"
+    "expo-module-scripts": "56.0.2",
+    "expo": "56.0.5"
   },
   "peerDependencies": {
     "expo": "*",
@@ -44,7 +44,7 @@
       "./scripts/xcode-build-bundle.sh"
     ]
   },
-  "gitHead": "e50d2c763bc89853aaa119d5729ba21197d230a7",
+  "gitHead": "f67a101bcbe56114e982184834b93da7bbed00af",
   "scripts": {
     "build": "expo-module build",
     "build:plugin": "expo-module build plugin",

package/plugin/build/android/resourceNames.d.ts

@@ -0,0 +1,5 @@
+import { WidgetConfig } from '../types/WidgetConfig.type';
+export declare const getProviderClassName: (widget: WidgetConfig) => string;
+export declare const getWidgetInfoResourceName: (widget: WidgetConfig) => string;
+export declare const getWidgetDisplayNameResourceName: (widget: WidgetConfig) => string;
+export declare const getWidgetDescriptionResourceName: (widget: WidgetConfig) => string;

package/plugin/build/android/resourceNames.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWidgetDescriptionResourceName = exports.getWidgetDisplayNameResourceName = exports.getWidgetInfoResourceName = exports.getProviderClassName = void 0;
+const toAndroidResourceName = (name) => {
+    const resourceName = name
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2')
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/[^A-Za-z0-9_]/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .toLowerCase();
+    return /^[a-z]/.test(resourceName) ? resourceName : `widget_${resourceName}`;
+};
+const getProviderClassName = (widget) => {
+    return `${widget.name}Provider`;
+};
+exports.getProviderClassName = getProviderClassName;
+const getWidgetInfoResourceName = (widget) => {
+    return `${toAndroidResourceName(widget.name)}_info`;
+};
+exports.getWidgetInfoResourceName = getWidgetInfoResourceName;
+const getWidgetDisplayNameResourceName = (widget) => {
+    return `${toAndroidResourceName(widget.name)}_display_name`;
+};
+exports.getWidgetDisplayNameResourceName = getWidgetDisplayNameResourceName;
+const getWidgetDescriptionResourceName = (widget) => {
+    return `${toAndroidResourceName(widget.name)}_description`;
+};
+exports.getWidgetDescriptionResourceName = getWidgetDescriptionResourceName;

package/plugin/build/android/withAndroidWidgetFiles.d.ts

@@ -0,0 +1,4 @@
+import { ConfigPlugin } from 'expo/config-plugins';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+declare const withAndroidWidgetFiles: ConfigPlugin<WidgetConfig[]>;
+export default withAndroidWidgetFiles;

package/plugin/build/android/withAndroidWidgetFiles.js

@@ -0,0 +1,142 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("expo/config-plugins");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const resourceNames_1 = require("./resourceNames");
+const withAndroidWidgetFiles = (config, widgets) => {
+    return (0, config_plugins_1.withDangerousMod)(config, [
+        'android',
+        async (config) => {
+            const androidPackage = config_plugins_1.AndroidConfig.Package.getPackage(config);
+            if (typeof androidPackage !== 'string' ||
+                !/^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)+$/.test(androidPackage)) {
+                throw new Error('Android package is required for expo-widgets. Please set `android.package` in `app.json` or `app.config.js`.');
+            }
+            const projectRoot = config.modRequest.platformProjectRoot;
+            const packageDirectory = path.join(projectRoot, 'app/src/main/java', ...androidPackage.split('.'));
+            const xmlDirectory = path.join(projectRoot, 'app/src/main/res/xml');
+            const valuesDirectory = path.join(projectRoot, 'app/src/main/res/values');
+            const widgetsXmlPath = path.join(xmlDirectory, 'expo_widgets.xml');
+            fs.mkdirSync(packageDirectory, { recursive: true });
+            fs.mkdirSync(xmlDirectory, { recursive: true });
+            fs.mkdirSync(valuesDirectory, { recursive: true });
+            if (fs.existsSync(widgetsXmlPath)) {
+                fs.rmSync(widgetsXmlPath);
+            }
+            fs.writeFileSync(widgetsXmlPath, createWidgetStringsXml(widgets));
+            for (const widget of widgets) {
+                const providerPath = path.join(packageDirectory, `${(0, resourceNames_1.getProviderClassName)(widget)}.kt`);
+                if (fs.existsSync(providerPath)) {
+                    fs.rmSync(providerPath);
+                }
+                fs.writeFileSync(path.join(packageDirectory, `${(0, resourceNames_1.getProviderClassName)(widget)}.kt`), createWidgetProviderKt(androidPackage, widget));
+                const widgetInfoPath = path.join(xmlDirectory, `${(0, resourceNames_1.getWidgetInfoResourceName)(widget)}.xml`);
+                if (fs.existsSync(widgetInfoPath)) {
+                    fs.rmSync(widgetInfoPath);
+                }
+                fs.writeFileSync(path.join(xmlDirectory, `${(0, resourceNames_1.getWidgetInfoResourceName)(widget)}.xml`), createWidgetInfoXml(widget));
+            }
+            return config;
+        },
+    ]);
+};
+const createWidgetProviderKt = (androidPackage, widget) => {
+    return `package ${androidPackage}
+
+import expo.modules.widgets.ExpoWidgetsAppWidgetProvider
+
+class ${(0, resourceNames_1.getProviderClassName)(widget)} : ExpoWidgetsAppWidgetProvider(${JSON.stringify(widget.name)})
+`;
+};
+const createWidgetInfoXml = (widget) => {
+    const android = getAndroidWidgetConfig(widget);
+    return `<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+  android:minWidth="${android.minWidth}dp"
+  android:minHeight="${android.minHeight}dp"
+  android:targetCellWidth="${android.targetCellWidth}"
+  android:targetCellHeight="${android.targetCellHeight}"
+  android:updatePeriodMillis="0"
+  android:initialLayout="@layout/glance_default_loading_layout"
+  android:description="@string/${(0, resourceNames_1.getWidgetDescriptionResourceName)(widget)}"
+  android:resizeMode="${getWidgetResizeMode(widget)}"
+  android:widgetCategory="home_screen" />
+`;
+};
+const getWidgetResizeMode = (widget) => {
+    const resizeMode = widget.android?.resizeMode;
+    switch (resizeMode) {
+        case 'none':
+            return 'none';
+        case 'horizontal':
+            return 'horizontal';
+        case 'vertical':
+            return 'vertical';
+        case 'both':
+        default:
+            return 'horizontal|vertical';
+    }
+};
+const getAndroidWidgetConfig = (widget) => {
+    return {
+        minWidth: widget.android?.minWidth ?? 180,
+        minHeight: widget.android?.minHeight ?? 110,
+        targetCellWidth: widget.android?.targetCellWidth ?? 4,
+        targetCellHeight: widget.android?.targetCellHeight ?? 2,
+    };
+};
+const escapeXmlSpecialChars = (value) => {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+};
+const createWidgetStringsXml = (widgets) => {
+    return `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+${widgets
+        .map((widget) => {
+        return `  <string name="${(0, resourceNames_1.getWidgetDisplayNameResourceName)(widget)}">${escapeXmlSpecialChars(widget.displayName)}</string>
+  <string name="${(0, resourceNames_1.getWidgetDescriptionResourceName)(widget)}">${escapeXmlSpecialChars(widget.description)}</string>`;
+    })
+        .join('\n')}
+</resources>
+`;
+};
+exports.default = withAndroidWidgetFiles;

package/plugin/build/android/withAndroidWidgetManifest.d.ts

@@ -0,0 +1,4 @@
+import { ConfigPlugin } from 'expo/config-plugins';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+declare const withAndroidWidgetManifest: ConfigPlugin<WidgetConfig[]>;
+export default withAndroidWidgetManifest;

package/plugin/build/android/withAndroidWidgetManifest.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("expo/config-plugins");
+const resourceNames_1 = require("./resourceNames");
+const EXPO_WIDGETS_INTERACTION_ACTION = 'expo.modules.widgets.ACTION_WIDGET_INTERACTION';
+const EXPO_WIDGETS_NAME_METADATA = 'expo.modules.widgets.NAME';
+const createWidgetReceiver = (widget) => {
+    return {
+        $: {
+            'android:name': `.${(0, resourceNames_1.getProviderClassName)(widget)}`,
+            'android:exported': 'true',
+            'android:label': `@string/${(0, resourceNames_1.getWidgetDisplayNameResourceName)(widget)}`,
+        },
+        'intent-filter': [
+            {
+                action: [
+                    {
+                        $: {
+                            'android:name': 'android.appwidget.action.APPWIDGET_UPDATE',
+                        },
+                    },
+                    {
+                        $: {
+                            'android:name': EXPO_WIDGETS_INTERACTION_ACTION,
+                        },
+                    },
+                ],
+            },
+        ],
+        'meta-data': [
+            {
+                $: {
+                    'android:name': 'android.appwidget.provider',
+                    'android:resource': `@xml/${(0, resourceNames_1.getWidgetInfoResourceName)(widget)}`,
+                },
+            },
+            {
+                $: {
+                    'android:name': EXPO_WIDGETS_NAME_METADATA,
+                    'android:value': widget.name,
+                },
+            },
+        ],
+    };
+};
+const withAndroidWidgetManifest = (config, widgets) => {
+    return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const mainApplication = config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+        const receivers = (mainApplication.receiver ?? []);
+        const isNotWidgetReceiver = (receiver) => !receiver['meta-data']?.some((metaData) => metaData.$['android:name'] === EXPO_WIDGETS_NAME_METADATA);
+        mainApplication.receiver = [
+            ...receivers.filter(isNotWidgetReceiver),
+            ...widgets.map(createWidgetReceiver),
+        ];
+        return config;
+    });
+};
+exports.default = withAndroidWidgetManifest;

package/plugin/build/android/withAndroidWidgets.d.ts

@@ -0,0 +1,6 @@
+import { ConfigPlugin } from 'expo/config-plugins';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+declare const withAndroidWidgets: ConfigPlugin<{
+    widgets: WidgetConfig[];
+}>;
+export default withAndroidWidgets;

package/plugin/build/android/withAndroidWidgets.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const withAndroidWidgetFiles_1 = __importDefault(require("./withAndroidWidgetFiles"));
+const withAndroidWidgetManifest_1 = __importDefault(require("./withAndroidWidgetManifest"));
+const withAndroidWidgets = (config, { widgets }) => {
+    if (widgets.length === 0) {
+        return config;
+    }
+    const androidWidgets = widgets.filter((widget) => widget.android !== null);
+    let nextConfig = config;
+    if (androidWidgets.length > 0) {
+        nextConfig = (0, withAndroidWidgetFiles_1.default)(nextConfig, androidWidgets);
+    }
+    return (0, withAndroidWidgetManifest_1.default)(nextConfig, androidWidgets);
+};
+exports.default = withAndroidWidgets;

package/plugin/build/ios/withIosWidgets.d.ts

@@ -0,0 +1,11 @@
+import { ConfigPlugin } from 'expo/config-plugins';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+type IosWidgetsProps = {
+    bundleIdentifier?: string;
+    groupIdentifier?: string;
+    enablePushNotifications?: boolean;
+    frequentUpdates?: boolean;
+    widgets: WidgetConfig[];
+};
+declare const withIosWidgets: ConfigPlugin<IosWidgetsProps>;
+export default withIosWidgets;

package/plugin/build/ios/withIosWidgets.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("expo/config-plugins");
+const withAppGroupEntitlements_1 = __importDefault(require("./withAppGroupEntitlements"));
+const withAppInfoPlist_1 = __importDefault(require("./withAppInfoPlist"));
+const withEasConfig_1 = __importDefault(require("./withEasConfig"));
+const withIosWarning_1 = __importDefault(require("./withIosWarning"));
+const withPodsLinking_1 = __importDefault(require("./withPodsLinking"));
+const withPushNotifications_1 = __importDefault(require("./withPushNotifications"));
+const withWidgetSourceFiles_1 = __importDefault(require("./withWidgetSourceFiles"));
+const withTargetXcodeProject_1 = __importDefault(require("./xcode/withTargetXcodeProject"));
+const withIosWidgets = (config, props) => {
+    const shouldConfigureIos = !!config.ios?.bundleIdentifier ||
+        !!props.bundleIdentifier ||
+        !!props.groupIdentifier ||
+        props.enablePushNotifications === true ||
+        props.frequentUpdates === true;
+    if (!shouldConfigureIos) {
+        return config;
+    }
+    let plugins = [];
+    const deploymentTarget = config.ios?.deploymentTarget ?? '16.4';
+    const targetName = 'ExpoWidgetsTarget';
+    const widgets = props.widgets.filter((widget) => widget.ios !== null);
+    const enablePushNotifications = props.enablePushNotifications ?? false;
+    const frequentUpdates = props.frequentUpdates ?? false;
+    let bundleIdentifier = props.bundleIdentifier;
+    if (!bundleIdentifier) {
+        bundleIdentifier = `${config.ios?.bundleIdentifier}.${targetName}`;
+        plugins.push([
+            withIosWarning_1.default,
+            {
+                property: 'bundleIdentifier',
+                warning: `Expo Widgets: No bundle identifier provided, using fallback: ${bundleIdentifier}.`,
+            },
+        ]);
+    }
+    let groupIdentifier = props.groupIdentifier;
+    if (!groupIdentifier) {
+        if (!config.ios?.bundleIdentifier) {
+            throw new Error('iOS bundle identifier is required. Please set `ios.bundleIdentifier` in `app.json` or `app.config.js`');
+        }
+        groupIdentifier = `group.${config.ios.bundleIdentifier}`;
+        plugins.push([
+            withIosWarning_1.default,
+            {
+                property: 'groupIdentifier',
+                warning: `Expo Widgets: No group identifier provided, using fallback: ${groupIdentifier}.`,
+            },
+        ]);
+    }
+    let sharedFiles = [];
+    const setFiles = (files) => {
+        sharedFiles = [...sharedFiles, ...files];
+    };
+    const getFileUris = () => sharedFiles;
+    plugins = [
+        ...plugins,
+        [withEasConfig_1.default, { targetName, bundleIdentifier, groupIdentifier }],
+        [withPodsLinking_1.default, { targetName }],
+        [withWidgetSourceFiles_1.default, { targetName, widgets, groupIdentifier, onFilesGenerated: setFiles }],
+        [withAppInfoPlist_1.default, { frequentUpdates, groupIdentifier }],
+        [withPushNotifications_1.default, { enablePushNotifications }],
+        [withAppGroupEntitlements_1.default, { groupIdentifier }],
+        [
+            withTargetXcodeProject_1.default,
+            {
+                targetName,
+                bundleIdentifier,
+                deploymentTarget,
+                appleTeamId: config.ios?.appleTeamId,
+                getFileUris,
+            },
+        ],
+    ];
+    return (0, config_plugins_1.withPlugins)(config, plugins);
+};
+exports.default = withIosWidgets;

package/plugin/build/{withWidgetSourceFiles.d.ts → ios/withWidgetSourceFiles.d.ts}

@@ -1,5 +1,5 @@
 import { ConfigPlugin } from 'expo/config-plugins';
-import { WidgetConfig } from './types/WidgetConfig.type';
+import { WidgetConfig } from '../types/WidgetConfig.type';
 type WidgetSourceFilesProps = {
     targetName: string;
     groupIdentifier: string;

package/plugin/build/{withWidgetSourceFiles.js → ios/withWidgetSourceFiles.js}

@@ -40,7 +40,7 @@ const plist_1 = __importDefault(require("@expo/plist"));
 const config_plugins_1 = require("expo/config-plugins");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const WidgetFamily_type_1 = require("./types/WidgetFamily.type");
+const WidgetFamily_type_1 = require("../types/WidgetFamily.type");
 const VALID_WIDGET_FAMILIES = new Set(Object.values(WidgetFamily_type_1.WidgetFamily));
 function assertSwiftIdentifier(value, label) {
     if (typeof value !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
@@ -54,11 +54,13 @@ function assertWidgetFamily(value) {
 }
 function validateWidget(widget) {
     assertSwiftIdentifier(widget.name, 'widget name');
-    for (const family of widget.supportedFamilies) {
+    const supportedFamilies = widget.ios?.supportedFamilies ?? widget.supportedFamilies ?? [];
+    for (const family of supportedFamilies) {
         assertWidgetFamily(family);
     }
-    if (widget.configuration) {
-        for (const [paramName, param] of Object.entries(widget.configuration.parameters)) {
+    const configuration = widget.ios?.configuration ?? widget.configuration;
+    if (configuration) {
+        for (const [paramName, param] of Object.entries(configuration.parameters)) {
             assertSwiftIdentifier(paramName, 'parameter name');
             if (param.type === 'number' && typeof param.default !== 'number') {
                 throw new Error(`Invalid default for ${JSON.stringify(paramName)}: must be a number.`);
@@ -154,7 +156,7 @@ struct ExportWidgets${index}: WidgetBundle {
   var body: some Widget {
     ${widgets
     .map((widget) => {
-    if (widget.configuration) {
+    if (widget.ios?.configuration ?? widget.configuration) {
         return `if #available(iOS 17.0, *) {
       ${widget.name}()
     }`;
@@ -166,7 +168,10 @@ struct ExportWidgets${index}: WidgetBundle {
   }
 }`;
 const widgetSwift = (widget) => {
-    if (!widget.configuration)
+    const configuration = widget.ios?.configuration ?? widget.configuration;
+    const supportedFamilies = widget.ios?.supportedFamilies ?? widget.supportedFamilies ?? [];
+    const contentMarginsDisabled = widget.ios?.contentMarginsDisabled ?? widget.contentMarginsDisabled;
+    if (!configuration)
         return `import WidgetKit
 import SwiftUI
 internal import ExpoWidgets
@@ -180,7 +185,7 @@ struct ${widget.name}: Widget {
     }
     .configurationDisplayName(${JSON.stringify(widget.displayName)})
     .description(${JSON.stringify(widget.description)})
-    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
+    .supportedFamilies([.${supportedFamilies.join(', .')}])${contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
     return `import WidgetKit
@@ -190,9 +195,9 @@ internal import ExpoWidgets
 
 // AppIntent
 struct ${widget.name}ConfigurationAppIntent: WidgetConfigurationIntent {
-  static var title: LocalizedStringResource = ${JSON.stringify(`${widget.configuration?.title ?? widget.displayName} Configuration`)}
-${widget.configuration?.description ? `  static var description: LocalizedStringResource = ${JSON.stringify(widget.configuration.description)}\n` : ''}
-${Object.entries(widget.configuration?.parameters ?? {})
+  static var title: LocalizedStringResource = ${JSON.stringify(`${configuration?.title ?? widget.displayName} Configuration`)}
+${configuration?.description ? `  static var description: LocalizedStringResource = ${JSON.stringify(configuration.description)}\n` : ''}
+${Object.entries(configuration?.parameters ?? {})
         .map(([name, param]) => {
         let paramType;
         switch (param.type) {
@@ -219,7 +224,7 @@ ${Object.entries(widget.configuration?.parameters ?? {})
     return .result()
   }
 }
-${Object.entries(widget.configuration?.parameters ?? {})
+${Object.entries(configuration?.parameters ?? {})
         .map(([name, param]) => {
         if (param.type !== 'enum')
             return '';
@@ -300,7 +305,7 @@ struct ${widget.name}EntryView: View {
     var env: [String: Any] = getWidgetEnvironment(environment: environment)
     env["timestamp"] = Int(entry.date.timeIntervalSince1970 * 1000)
     env["configuration"] = [
-${Object.entries(widget.configuration?.parameters ?? {})
+${Object.entries(configuration?.parameters ?? {})
         .map(([name, param]) => {
         return `      "${name}": entry.configuration.${name}${param.type === 'enum' ? '.rawValue' : ''}`;
     })
@@ -339,7 +344,7 @@ struct ${widget.name}: Widget {
     }
     .configurationDisplayName(${JSON.stringify(widget.displayName)})
     .description(${JSON.stringify(widget.description)})
-    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
+    .supportedFamilies([.${supportedFamilies.join(', .')}])${contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
 };

package/plugin/build/types/WidgetConfig.type.d.ts

@@ -1,15 +1,31 @@
 import { WidgetFamily } from './WidgetFamily.type';
 export type WidgetConfig = {
     name: string;
-    supportedFamilies: WidgetFamily[];
     displayName: string;
     description: string;
+    supportedFamilies: WidgetFamily[];
     contentMarginsDisabled: boolean;
     configuration?: {
         title: string;
         description?: string;
         parameters: Record<string, WidgetParameter>;
     };
+    ios?: {
+        supportedFamilies: WidgetFamily[];
+        contentMarginsDisabled?: boolean;
+        configuration?: {
+            title: string;
+            description?: string;
+            parameters: Record<string, WidgetParameter>;
+        };
+    } | null;
+    android?: {
+        minWidth?: number;
+        minHeight?: number;
+        targetCellWidth?: number;
+        targetCellHeight?: number;
+        resizeMode?: 'none' | 'horizontal' | 'vertical' | 'both';
+    } | null;
 };
 export type WidgetParameterString = {
     title: string;