@effijs/templates 0.0.0-stage → 1.0.0-alpha.1

package/platforms/react-native/ORIGIN.md

@@ -0,0 +1,42 @@
+# Origin
+
+The React Native templates were copied once from `examples/testForgeFsd863/src` on 2026-10-18. The repo HEAD at that copy was `287f769`. The plan named commit `4f5a6e1`; that commit is not in this clone, so the working tree of the example is the source of truth. `packages/templates.back` supplied the React Navigation and Expo stubs and the Slider, Ruler, Calendar, and Chart sources.
+
+Refresh with:
+
+```bash
+node packages/templates/scripts/stage-origin.mjs
+node packages/templates/scripts/write-solutions.mjs
+```
+
+`stage-origin.mjs` recopies and reapplies the adaptations below. Re-check markers after a refresh. `write-solutions.mjs` rewrites `solution.js` and `README.md` but keeps hand-written Firebase and permissions sources only if you do not delete those directories first. The script writes those two services as well.
+
+## What moved where
+
+| Template | Example |
+| --- | --- |
+| `generators/init/files` | `src` without product, category, and the solution-only components |
+| `generators/demo/files` | `entity/product`, `entity/category`, `feature/product`, `navigation.product.ts`, `api/` |
+| `solutions/components/BottomSheet` and the other example components | `src/ui/components/<Name>` |
+| `solutions/components/BottomSheetWidgets` | `src/ui/widgets/bottomSheet` plus `Form/SelectPicker.tsx` |
+| `shared/solutions/utils/string` and `date` | `src/utils/string.ts`, `src/utils/date.ts` |
+
+## Adaptations
+
+- Home is a placeholder. Demo points it at the product list.
+- `entity/index.ts` and `feature/index.ts` register only auth and profile, plus markers.
+- `navigation.features.ts` starts empty, with markers.
+- Base UI is Box, Grid, Text, Button, Screen, Form, TextInput, Icon, Loading, ThemePicker.
+- Button, Form Input, and InputArea use `ActivityIndicator` instead of ProgressIndicator.
+- Splash and Profile use React Native `Image`. Screen header dropped an unused Image import.
+- Form does not ship DateTimePicker, SelectPicker, Checkbox, RadioGroup, or InputSecurity. Those are solutions, except RadioGroup, which imported a missing `RadioButton` and was left out.
+- Config `API_URL` is `{{{apiUrl}}}` in `configs/dev.ts.hbs` and `configs/prod.ts.hbs`. Init renders that from the `apiUrl` answer. The stage script renames the copied `.ts` files to `.hbs` after writing the token.
+- Navigator stubs keep the example class shape (`NavigationApp`, `NavigationFeatures`, `NavigationTabs`, `NavigationWidgets`) with TODO methods for `goToSplash`, `goToSignIn`, `goToSignUp`, `goToOnboarding`, `goToTabs`, and `showToast`.
+- Skia stays on Image and ProgressIndicator. It is not a setup dependency.
+
+## How to update
+
+1. Diff `examples/testForgeFsd863/src` against `generators/init/files` and `generators/demo/files`.
+2. Run the stage script only when you intend to take the example again.
+3. Search for `// forge:` and confirm every marker listed in the platform README is still present.
+4. Run `npm test` and `npm run docs:check`.

package/platforms/react-native/README.md

@@ -0,0 +1,78 @@
+# React Native FSD
+
+`rn-fsd` takes a React Native CLI app to an EffiJS Feature-Sliced Design tree. Forge's core is unchanged. Dependency installs, config merges, summaries, and migrations live in this package.
+
+```mermaid
+flowchart TD
+  rnInit["npx @react-native-community/cli init MyApp"] --> addPkgs["yarn add -D @effijs/forge @effijs/templates"]
+  addPkgs --> forgeInit["npx forge init"]
+  forgeInit --> setup["forge g setup"]
+  setup -->|"patch failed"| migration[".forge/migrations"]
+  setup --> init["forge g init"]
+  init --> demo["forge g demo"]
+  init --> entity["forge g entity"]
+  init --> feature["forge g feature"]
+  init --> component["forge g component"]
+  init --> add["forge g add / forge g util"]
+```
+
+## New project
+
+```bash
+npx @react-native-community/cli init MyApp --version 0.86.3
+cd MyApp
+yarn add -D @effijs/forge @effijs/templates
+npx forge init
+npx forge g setup
+npx forge g init --api-url https://api.example.com/
+```
+
+`setup` rewrites `forge.config.js` with `presetMap` set to `@effijs/templates/presets/react-native-fsd`. `addMany` byte-copies files that are not `.hbs`. Barrel registration uses `append` with `pattern`, `before: true`, and `unique: true`.
+
+## Existing project
+
+Run `forge g setup` in the app root, then `forge g init`. Init copies `src` and does not delete screens you already have unless a path collides. Use `--force` to overwrite collisions.
+
+## Commands
+
+```bash
+npx forge g setup --navigator react-native-navigation
+npx forge g setup --link-local ~/projects/npm/EffiJS/effijs
+npx forge g init --api-url https://api.example.com/
+npx forge g demo
+npx forge g entity --name Invoice --variant crud --fields "title:string,price:number"
+npx forge g feature --name Invoice --screens all --tab
+npx forge g component --name Avatar --base Pressable --extend Box
+npx forge g add --id component:BottomSheet
+npx forge g util --id util:permissions
+```
+
+`--yes` skips questions and applies each prompt's `default`.
+
+`--link-local` is read from the process arguments. Forge does not declare that flag. It adds `watchFolders` and `extraNodeModules` to a stock `metro.config.js`.
+
+## Markers
+
+Generators insert at `// forge:<name>` and leave the marker in place:
+
+- `entity`, `feature`
+- `navigation-features-import`, `navigation-features`
+- `navigation-tabs`, `navigation-tabs-register`
+- `components-import`, `components-export`
+- `services`, `utils`
+- `form-imports`, `form-types`, `form-elements`
+
+## Migrations and AI
+
+When a config is not plain data, setup writes `.forge/migrations/*.md` and prints:
+
+`Apply .forge/migrations/<file>.md following node_modules/@effijs/templates/platforms/react-native/ai/SETUP.md`
+
+The same prompt is inside the migration file. Summaries are printed and saved to `.forge/summary/`.
+
+## Limitations
+
+- React Native Navigation (Wix) is implemented, including `npx rnn-link` and a native marker check. React Navigation and Expo Router get class stubs with TODO bodies. `Screen` is still the Wix screen from the example.
+- Android linking snippets in the migration come from the React Native Navigation install guide. The example app has not linked Android yet, so those snippets must be checked against the project's Kotlin files. The iOS `AppDelegate.swift` matches the example.
+- pnpm cannot resolve a bare preset id from a sibling folder. Use the generated `forge.config.js`.
+- Parts of Form that need extra packages are solutions: DateTimePicker, SelectPicker, InputSecurity. ProgressIndicator and Image are solutions too. The base Button and inputs use `ActivityIndicator`.

package/platforms/react-native/ai/AGENTS.md.hbs

@@ -0,0 +1,36 @@
+# AGENTS.md
+
+This React Native app uses Feature-Sliced Design and EffiJS. Navigation library: {{{navigator}}}. API base URL: {{{apiUrl}}}.
+
+## Layout
+
+- `src/app` — startup, splash, onboarding, tabs
+- `src/entity` — api, dto, store, service
+- `src/feature` — screens and feature services
+- `src/navigation` — navigator classes
+- `src/services` — http and other process-wide services
+- `src/ui` — theme, widgets, components
+- `src/utils` — shared helpers
+
+## Forge commands
+
+```bash
+npx forge g setup
+npx forge g init
+npx forge g demo
+npx forge g entity --name Invoice
+npx forge g feature --name Invoice --screens all
+npx forge g component --name Avatar
+npx forge g add --id component:BottomSheet
+npx forge g util --id util:permissions
+```
+
+Ready-made components, services, and utils are listed in `node_modules/@effijs/templates/platforms/react-native/CATALOG.md`. Prefer `forge g add` over writing a listed piece from scratch.
+
+## Markers
+
+Generators insert code at `// forge:<name>` comments. Do not delete those comments.
+
+## Config changes
+
+If setup could not patch a config, follow `.forge/migrations/*.md` and `node_modules/@effijs/templates/platforms/react-native/ai/SETUP.md`.

package/platforms/react-native/ai/SETUP.md

@@ -0,0 +1,89 @@
+# Setup requirements
+
+Use this file when applying `.forge/migrations/*.md` by hand or with an agent. Change only the config named in the migration. Keep a backup. After each file, the app should still boot `index.js`, which must load `./src`.
+
+## .nvmrc
+
+The active matrix row names the Node version. Create the file when it is missing. Replace a different version and mention the old value in the summary.
+
+## tsconfig.json
+
+Keep the existing `extends`. Set:
+
+- `compilerOptions.experimentalDecorators` and `compilerOptions.emitDecoratorMetadata` to true
+- `compilerOptions.types` to include `jest`
+- `compilerOptions.paths` for `@*`, `@components`, `@icons`, `@images`, `@widgets`, and `@theme`
+- `exclude` to include `**/node_modules`, `**/Pods`, and `backup/**`
+
+Edit with a JSONC-aware tool so comments survive.
+
+## babel.config.js
+
+Plain object only. Plugin order:
+
+1. `babel-plugin-transform-typescript-metadata`
+2. `@babel/plugin-proposal-decorators` with `{ legacy: true }`
+3. The project's other plugins, including `@babel/plugin-transform-export-namespace-from`
+4. `module-resolver` with `root: ['./src']` and the EffiJS aliases (`@app`, `@entity`, `@feature`, `@navigation`, `@services`, `@components`, `@theme`, `@utils`, and the rest from the example)
+5. The matrix's last plugin: `react-native-worklets/plugin` on 0.86, `react-native-reanimated/plugin` on 0.84
+
+If the file exports a function, do not rewrite it. Follow the migration instead.
+
+## jest.config.js
+
+Keep `preset: '@react-native/jest-preset'`. Ignore `/node_modules/` and `/backup/`. `testEnvironment` may be `'node'`. Leave function-valued configs for a migration.
+
+## .prettierrc.js
+
+Merge, do not drop user keys: `arrowParens: 'avoid'`, `singleQuote: true`, `trailingComma: 'all'`, `printWidth: 120`, `bracketSpacing: true`, `bracketSameLine: true`.
+
+## react-native.config.js
+
+`assets` must include `./src/ui/fonts/`. Keep `project.ios` and `project.android`.
+
+## metro.config.js
+
+Leave the stock file unchanged unless setup was run with `--link-local <path>`. That flag fills `watchFolders` and `resolver.extraNodeModules` for the EffiJS packages in that checkout. If `config` is not an empty object, follow the migration.
+
+## forge.config.js
+
+```js
+export default {
+  presets: ['rn-fsd'],
+  presetMap: {
+    'rn-fsd': '@effijs/templates/presets/react-native-fsd',
+  },
+  primaryPreset: 'rn-fsd',
+  packageManager: 'yarn',
+  navigator: 'react-native-navigation',
+  outputDir: './src',
+  templateEngine: 'handlebars',
+  generators: [
+    'rn-fsd:setup', 'rn-fsd:init', 'rn-fsd:demo', 'rn-fsd:entity',
+    'rn-fsd:feature', 'rn-fsd:component', 'rn-fsd:add', 'rn-fsd:util',
+  ],
+  aliases: {
+    setup: 'rn-fsd:setup', init: 'rn-fsd:init', demo: 'rn-fsd:demo',
+    entity: 'rn-fsd:entity', feature: 'rn-fsd:feature',
+    comp: 'rn-fsd:component', component: 'rn-fsd:component',
+    add: 'rn-fsd:add', util: 'rn-fsd:util',
+  },
+};
+```
+
+`presetMap` is the package path. Forge resolves it through Node, including the package `exports` entry.
+
+## index.js
+
+A stock AppRegistry file becomes `import './src';`. If the file was edited by hand, follow the migration. After confirmation, move `App.tsx` and `__tests__/App.test.tsx` to `.forge/backup/`.
+
+## React Native Navigation
+
+`npx rnn-link` must leave `NavigationActivity` and `NavigationApplication` on Android and `RNNAppDelegate` on iOS. The migration's Swift file matches the EffiJS example. The Kotlin fragments are the install-guide shape and have to be checked against this app's current activity and application classes.
+
+## Order
+
+1. Read the migration title and target.
+2. Apply that file only, using the section above.
+3. Leave `// forge:` markers in `src` untouched.
+4. Stop when the migration's required change is present.

package/platforms/react-native/compat/matrix.js

@@ -0,0 +1,150 @@
+const sharedDependencies = {
+  '@effijs/common': '3.0.1',
+  '@effijs/form-react': '3.0.0',
+  '@effijs/logger': '3.0.0',
+  '@effijs/props-manager': '3.0.0',
+  '@effijs/theme': '3.0.0',
+  ramda: '0.32.0',
+  dayjs: '1.11.23',
+  'query-string': '9.5.0',
+  'react-native-gesture-handler': '3.2.1',
+  'react-native-keyboard-controller': '1.22.4',
+  'react-native-mmkv': '4.3.2',
+  'react-native-safe-area-context': '5.9.1',
+};
+
+const sharedDevDependencies = {
+  '@babel/plugin-proposal-decorators': '7.29.7',
+  '@babel/plugin-transform-export-namespace-from': '7.29.7',
+  '@types/ramda': '0.32.0',
+  'babel-plugin-module-resolver': '5.0.3',
+  'babel-plugin-transform-typescript-metadata': '0.4.0',
+  eslint: '8.57.1',
+  'eslint-config-prettier': '10.1.8',
+  'eslint-import-resolver-typescript': '4.4.5',
+  'eslint-plugin-ft-flow': '3.0.11',
+  'eslint-plugin-import': '2.32.0',
+  'eslint-plugin-jest': '29.15.4',
+  'eslint-plugin-prettier': '5.5.6',
+  prettier: '3.9.4',
+  'react-native-asset': '2.1.1',
+};
+
+const wixDependencies = {
+  '@effijs/navigation-react-native': '3.0.1',
+  'react-native-navigation': '8.8.11',
+};
+
+const iosAppDelegate = `import UIKit
+import React
+import ReactNativeNavigation
+import ReactAppDependencyProvider
+
+@main
+class AppDelegate: RNNAppDelegate {
+  override func application(
+    _ application: UIApplication,
+    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
+  ) -> Bool {
+    self.reactNativeDelegate = ReactNativeDelegate()
+    super.application(application, didFinishLaunchingWithOptions: launchOptions)
+
+    return true
+  }
+}
+
+class ReactNativeDelegate: RCTDefaultReactNativeFactoryDelegate {
+  override func sourceURL(for bridge: RCTBridge) -> URL? {
+    self.bundleURL()
+  }
+
+  override func bundleURL() -> URL? {
+#if DEBUG
+    RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")
+#else
+    Bundle.main.url(forResource: "main", withExtension: "jsbundle")
+#endif
+  }
+}
+`;
+
+const androidMainActivity = `import com.reactnativenavigation.NavigationActivity
+
+class MainActivity : NavigationActivity()
+`;
+
+const androidMainApplication = `import android.app.Application
+import com.facebook.react.PackageList
+import com.facebook.react.ReactNativeHost
+import com.facebook.react.ReactPackage
+import com.reactnativenavigation.NavigationApplication
+import com.reactnativenavigation.react.NavigationReactNativeHost
+
+class MainApplication : NavigationApplication() {
+  override val reactNativeHost: ReactNativeHost =
+    object : NavigationReactNativeHost(this) {
+      override fun getPackages(): List<ReactPackage> = PackageList(this).packages
+      override fun getJSMainModuleName(): String = "index"
+      override fun getUseDeveloperSupport(): Boolean = BuildConfig.DEBUG
+      override val isNewArchEnabled: Boolean = BuildConfig.IS_NEW_ARCHITECTURE_ENABLED
+      override val isHermesEnabled: Boolean = BuildConfig.IS_HERMES_ENABLED
+    }
+}
+`;
+
+export const matrix = [
+  {
+    id: '0.84',
+    range: '>=0.84.0 <0.85.0',
+    node: '22.11.0',
+    babelPluginLast: 'react-native-reanimated/plugin',
+    dependencies: {
+      ...sharedDependencies,
+      'react-native-reanimated': '3.17.5',
+    },
+    devDependencies: sharedDevDependencies,
+    navigators: {
+      'react-native-navigation': { dependencies: wixDependencies },
+      'react-navigation': { dependencies: {} },
+      'expo-router': { dependencies: {} },
+    },
+    native: { iosAppDelegate, androidMainActivity, androidMainApplication },
+    optional: {
+      skia: { dependencies: { '@shopify/react-native-skia': '2.2.12' } },
+      validator: { dependencies: { validator: '13.15.0' } },
+      'firebase-app': { dependencies: { '@react-native-firebase/app': '22.4.0' } },
+      'firebase-messaging': { dependencies: { '@react-native-firebase/messaging': '22.4.0' } },
+    },
+  },
+  {
+    id: '0.86',
+    range: '>=0.85.0 <0.87.0',
+    node: '22.22.1',
+    babelPluginLast: 'react-native-worklets/plugin',
+    dependencies: {
+      ...sharedDependencies,
+      'react-native-reanimated': '4.5.3',
+      'react-native-worklets': '0.11.4',
+    },
+    devDependencies: sharedDevDependencies,
+    navigators: {
+      'react-native-navigation': { dependencies: wixDependencies },
+      'react-navigation': { dependencies: {} },
+      'expo-router': { dependencies: {} },
+    },
+    native: { iosAppDelegate, androidMainActivity, androidMainApplication },
+    optional: {
+      skia: { dependencies: { '@shopify/react-native-skia': '2.11.0' } },
+      validator: { dependencies: { validator: '13.15.0' } },
+      'firebase-app': { dependencies: { '@react-native-firebase/app': '23.5.0' } },
+      'firebase-messaging': { dependencies: { '@react-native-firebase/messaging': '23.5.0' } },
+    },
+  },
+];
+
+export function dependenciesFor(entry, navigator) {
+  return {
+    ...entry.dependencies,
+    ...(entry.navigators[navigator]?.dependencies ?? {}),
+  };
+}

package/platforms/react-native/configs/babel.js

@@ -0,0 +1,63 @@
+export const ALIASES = {
+  '@configs': './src/configs',
+  '@app': './src/app',
+  '@entity': './src/entity',
+  '@feature': './src/feature',
+  '@navigation': './src/navigation',
+  '@services': './src/services',
+  '@ui': './src/ui',
+  '@components': './src/ui/components',
+  '@icons': './src/ui/icons',
+  '@images': './src/ui/images',
+  '@widgets': './src/ui/widgets',
+  '@theme': './src/ui/theme/',
+  '@utils': './src/utils',
+  '@i18n': './src/i18n',
+  '@screens': './src/screens',
+};
+
+const HEAD = ['babel-plugin-transform-typescript-metadata', '@babel/plugin-proposal-decorators'];
+const TAIL_NAMES = new Set(['module-resolver', 'react-native-reanimated/plugin', 'react-native-worklets/plugin']);
+
+export function pluginName(plugin) {
+  if (typeof plugin === 'string') return plugin;
+  if (Array.isArray(plugin) && typeof plugin[0] === 'string') return plugin[0];
+  return null;
+}
+
+export function mergeBabelConfig(current, { lastPlugin }) {
+  const presets = Array.isArray(current.presets) ? [...current.presets] : [];
+  if (!presets.some((item) => String(pluginName(item)).includes('@react-native/babel-preset'))) {
+    presets.unshift('module:@react-native/babel-preset');
+  }
+
+  const incoming = Array.isArray(current.plugins) ? current.plugins : [];
+  const middle = incoming.filter((plugin) => {
+    const name = pluginName(plugin);
+    return name && !HEAD.includes(name) && !TAIL_NAMES.has(name);
+  });
+  if (!middle.some((plugin) => pluginName(plugin) === '@babel/plugin-transform-export-namespace-from')) {
+    middle.unshift('@babel/plugin-transform-export-namespace-from');
+  }
+
+  const plugins = [
+    'babel-plugin-transform-typescript-metadata',
+    ['@babel/plugin-proposal-decorators', { legacy: true }],
+    ...middle,
+    [
+      'module-resolver',
+      {
+        root: ['./src'],
+        extensions: ['.ios.js', '.android.js', '.js', '.ts', '.tsx', '.json'],
+        alias: ALIASES,
+      },
+    ],
+    lastPlugin,
+  ];
+
+  return { ...current, presets, plugins };
+}
+
+export function printModuleExports(value) {
+  return `module.exports = ${JSON.stringify(value, null, 2)};\n`;
+}

package/platforms/react-native/configs/forgeConfig.js

@@ -0,0 +1,35 @@
+export function renderForgeConfig({ packageManager, navigator }) {
+  return `export default {
+  presets: ['rn-fsd'],
+  presetMap: {
+    'rn-fsd': '@effijs/templates/presets/react-native-fsd',
+  },
+  primaryPreset: 'rn-fsd',
+  packageManager: '${packageManager}',
+  navigator: '${navigator}',
+  outputDir: './src',
+  templateEngine: 'handlebars',
+  generators: [
+    'rn-fsd:setup',
+    'rn-fsd:init',
+    'rn-fsd:demo',
+    'rn-fsd:entity',
+    'rn-fsd:feature',
+    'rn-fsd:component',
+    'rn-fsd:add',
+    'rn-fsd:util',
+  ],
+  aliases: {
+    setup: 'rn-fsd:setup',
+    init: 'rn-fsd:init',
+    demo: 'rn-fsd:demo',
+    entity: 'rn-fsd:entity',
+    feature: 'rn-fsd:feature',
+    comp: 'rn-fsd:component',
+    component: 'rn-fsd:component',
+    add: 'rn-fsd:add',
+    util: 'rn-fsd:util',
+  },
+};
+`;
+}

package/platforms/react-native/configs/jsConfigs.js

@@ -0,0 +1,96 @@
+import { isPlainData, requireCjs } from '../../../lib/patch.js';
+import { mergeBabelConfig, printModuleExports } from './babel.js';
+
+export function patchBabel(file, content, { exists, lastPlugin }) {
+  if (!exists) {
+    return {
+      ok: true,
+      content: printModuleExports(mergeBabelConfig({ presets: ['module:@react-native/babel-preset'], plugins: [] }, { lastPlugin })),
+    };
+  }
+  let loaded;
+  try {
+    loaded = requireCjs(file);
+  } catch (error) {
+    return { ok: false, reason: `Could not load babel.config.js: ${error.message}` };
+  }
+  if (!isPlainData(loaded)) {
+    return { ok: false, reason: 'babel.config.js exports functions or class instances.' };
+  }
+  return { ok: true, content: printModuleExports(mergeBabelConfig(loaded, { lastPlugin })) };
+}
+
+export function patchJest(file, content, { exists }) {
+  if (!exists) {
+    return { ok: true, content: printJest(defaultJest()) };
+  }
+  let loaded;
+  try {
+    loaded = requireCjs(file);
+  } catch (error) {
+    return { ok: false, reason: `Could not load jest.config.js: ${error.message}` };
+  }
+  if (!isPlainData(loaded)) {
+    return { ok: false, reason: 'jest.config.js exports functions or class instances.' };
+  }
+  return { ok: true, content: printJest({ ...defaultJest(), ...loaded, preset: loaded.preset ?? '@react-native/jest-preset' }) };
+}
+
+function defaultJest() {
+  return {
+    preset: '@react-native/jest-preset',
+    testPathIgnorePatterns: ['/node_modules/', '/backup/'],
+    testEnvironment: 'node',
+    transformIgnorePatterns: [
+      'node_modules/(?!(@react-native|react-native|query-string|decode-uri-component|split-on-first|filter-obj)/)',
+    ],
+  };
+}
+
+function printJest(value) {
+  return `module.exports = ${JSON.stringify(value, null, 2)};\n`;
+}
+
+export function patchPrettier(file, content, { exists }) {
+  const defaults = {
+    arrowParens: 'avoid',
+    bracketSameLine: true,
+    bracketSpacing: true,
+    singleQuote: true,
+    trailingComma: 'all',
+    printWidth: 120,
+  };
+  if (!exists) return { ok: true, content: `module.exports = ${JSON.stringify(defaults, null, 2)};\n` };
+  let loaded;
+  try {
+    loaded = requireCjs(file);
+  } catch (error) {
+    return { ok: false, reason: `Could not load Prettier config: ${error.message}` };
+  }
+  if (!isPlainData(loaded)) {
+    return { ok: false, reason: 'Prettier config exports functions or class instances.' };
+  }
+  return { ok: true, content: `module.exports = ${JSON.stringify({ ...defaults, ...loaded }, null, 2)};\n` };
+}
+
+export function patchRnConfig(file, content, { exists }) {
+  const defaults = {
+    project: { ios: {}, android: {} },
+    assets: ['./src/ui/fonts/'],
+  };
+  if (!exists) return { ok: true, content: `module.exports = ${JSON.stringify(defaults, null, 2)};\n` };
+  let loaded;
+  try {
+    loaded = requireCjs(file);
+  } catch (error) {
+    return { ok: false, reason: `Could not load react-native.config.js: ${error.message}` };
+  }
+  if (!isPlainData(loaded)) {
+    return { ok: false, reason: 'react-native.config.js exports functions or class instances.' };
+  }
+  const assets = new Set([...(loaded.assets ?? []), ...defaults.assets]);
+  return {
+    ok: true,
+    content: `module.exports = ${JSON.stringify({ ...loaded, project: { ...defaults.project, ...loaded.project }, assets: [...assets] }, null, 2)};\n`,
+  };
+}

package/platforms/react-native/configs/metro.js

@@ -0,0 +1,86 @@
+import path from 'node:path';
+
+const PACKAGES = [
+  '@effijs/common',
+  '@effijs/props-manager',
+  '@effijs/theme',
+  '@effijs/logger',
+  '@effijs/form-react',
+  '@effijs/navigation-react-native',
+  '@effijs/forge',
+  '@effijs/templates',
+];
+
+export function linkLocalSource(linkRoot) {
+  const root = JSON.stringify(linkRoot);
+  const entries = PACKAGES.map((name) => {
+    const folder = name.split('/')[1];
+    return `  '${name}': path.join(${root}, 'packages/${folder}'),`;
+  }).join('\n');
+  return `const path = require('path');
+
+const linkedPackages = {
+${entries}
+};
+
+const config = {
+  watchFolders: [...Object.values(linkedPackages)],
+  resolver: {
+    extraNodeModules: new Proxy(linkedPackages, {
+      get: (target, name) => {
+        if (name in target) return target[name];
+        return path.join(__dirname, 'node_modules', name);
+      },
+    }),
+  },
+};
+`;
+}
+
+export function patchMetro(content, { exists, linkLocal }) {
+  if (!linkLocal) return { ok: true, content, unchanged: true };
+  if (!exists) {
+    return {
+      ok: false,
+      reason: 'metro.config.js does not exist, so local package linking was not applied.',
+    };
+  }
+  if (content.includes('linkedPackages')) return { ok: true, content };
+  if (!content.includes('mergeConfig(getDefaultConfig(__dirname), config)')) {
+    return {
+      ok: false,
+      reason: 'metro.config.js does not match the React Native CLI template, so watchFolders were not inserted.',
+    };
+  }
+  const block = linkLocalSource(path.resolve(linkLocal));
+  let next = content;
+  if (!next.includes("require('path')") && !next.includes('require("path")')) {
+    next = `const path = require('path');\n${next}`;
+  }
+  if (/const config = \{\s*\};/.test(next)) {
+    next = next.replace(/const config = \{\s*\};/, block.trim().replace(/^const path = require\('path'\);\n\n/, ''));
+  } else {
+    return {
+      ok: false,
+      reason: 'metro.config.js has a non-empty config object, so local linking was not inserted.',
+    };
+  }
+  return { ok: true, content: next };
+}
+
+export function patchIndexJs(content, { exists }) {
+  if (!exists) return { ok: true, content: "import './src';\n" };
+  if (content.includes("import './src'") || content.includes('import "./src"')) {
+    return { ok: true, content };
+  }
+  const standard =
+    content.includes('AppRegistry.registerComponent') &&
+    (content.includes("from './App'") || content.includes('from "./App"'));
+  if (!standard) {
+    return {
+      ok: false,
+      reason: 'index.js does not match the React Native AppRegistry template.',
+    };
+  }
+  return { ok: true, content: "import './src';\n" };
+}