ReactNative: Overhaul RN setup

MIGRATION.md

@@ -1,5 +1,7 @@
 <h1>Migration</h1>
 
+- [From version 10.3.0 to 10.4.0](#from-version-1030-to-1040)
+  - [React Native: on-device addons moved to `deviceAddons`](#react-native-on-device-addons-moved-to-deviceaddons)
 - [From version 10.0.0 to 10.1.0](#from-version-1000-to-1010)
   - [API and Component Changes](#api-and-component-changes)
     - [Button Component API Changes](#button-component-api-changes)
@@ -520,6 +522,36 @@
   - [Packages renaming](#packages-renaming)
   - [Deprecated embedded addons](#deprecated-embedded-addons)
 
+## From version 10.3.0 to 10.4.0
+
+### React Native: on-device addons moved to `deviceAddons`
+
+In Storybook 10.4, on-device addons (those whose package name contains `"ondevice"`, such as `@storybook/addon-ondevice-controls` and `@storybook/addon-ondevice-actions`) must be listed under the `deviceAddons` key in your `.rnstorybook/main.ts` instead of the shared `addons` key.
+
+Listing them in `addons` caused `storybook extract` to fail because Storybook Core tries to evaluate every entry in `addons` as a Node.js preset, which these on-device addons are not.
+
+The automigration (`rn-ondevice-addons-to-device-addons`) handles this automatically, but you can also migrate manually:
+
+```ts
+// Before (.rnstorybook/main.ts)
+export default {
+  addons: [
+    '@storybook/addon-ondevice-controls',
+    '@storybook/addon-ondevice-actions',
+    '@storybook/addon-docs',
+  ],
+};
+
+// After (.rnstorybook/main.ts)
+export default {
+  addons: ['@storybook/addon-docs'],
+  deviceAddons: [
+    '@storybook/addon-ondevice-controls',
+    '@storybook/addon-ondevice-actions',
+  ],
+};
+```
+
 ## From version 10.0.0 to 10.1.0
 
 ### API and Component Changes

code/core/src/shared/constants/config-folder.ts

@@ -0,0 +1,2 @@
+/** Default React Native on-device Storybook config directory name. */
+export const RN_STORYBOOK_DIR = '.rnstorybook';

code/lib/cli-storybook/src/automigrate/fixes/index.ts

@@ -16,6 +16,7 @@ import { removeAddonInteractions } from './remove-addon-interactions.ts';
 import { removeDocsAutodocs } from './remove-docs-autodocs.ts';
 import { removeEssentials } from './remove-essentials.ts';
 import { rendererToFramework } from './renderer-to-framework.ts';
+import { rnOndeviceAddonsToDeviceAddons } from './rn-ondevice-addons-to-device-addons.ts';
 import { rnstorybookConfig } from './rnstorybook-config.ts';
 import { storybookPackageNameConflict } from './storybook-package-name-conflict.ts';
 import { upgradeStorybookRelatedDependencies } from './upgrade-storybook-related-dependencies.ts';
@@ -34,6 +35,7 @@ export const allFixes: Fix[] = [
   consolidatedImports,
   addonExperimentalTest,
   rnstorybookConfig,
+  rnOndeviceAddonsToDeviceAddons,
   migrateAddonConsole,
   nextjsToNextjsVite,
   removeAddonInteractions,