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

package/platforms/react-native/generators/init/files/utils/string.ts

@@ -0,0 +1,100 @@
+export function capitalize(text?: string): string {
+  if (!text?.length) return '';
+
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}
+
+export function sanitizeText(input?: string): string {
+  if (!input) return '';
+  const normalized = input
+    .replace(/[\u2018\u2019\u201A\u201B\u2032\u2035]/g, "'")
+    .replace(/[\u201C\u201D\u2033\u2036]/g, '"')
+    .normalize('NFKD')
+    .replace(/[\u0300-\u036f]/g, '');
+  // Keep ASCII letters/digits/space and common punctuation . - ' "
+  return normalized
+    .replace(/[^A-Za-z0-9 .\-'"]/g, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+export function sanitizeAndNormalizeText(value: string | undefined | null): string {
+  if (!value) return value || '';
+
+  return value.replace(/[^a-z0-9/\-?:().,'+ ]/gi, '').replace(/([/\-?:().,'+ ])(?=\1)/g, '');
+}
+
+export const textTransformers = {
+  disableCyrillic: (text: string) => text.replace(/[А-Яа-яЁёЇїІіЄєҐґ]/g, ''),
+  sanitize: (text: string) => text.replace(/[^a-z0-9/\-?:().,'+ ]/gi, ''),
+  deduplicate: (text: string) => text.replace(/([/\-?:().,'+ ])(?=\1)/g, ''),
+  trim: (text: string) => text.trim(),
+  noSpaces: (text: string) => text.replace(/\s+/g, ''),
+  upperCase: (text: string) => text.toUpperCase(),
+  extractNumber: (value: unknown): number => {
+    if (typeof value === 'number') {
+      return Number.isFinite(value) ? value : 0;
+    }
+
+    if (typeof value !== 'string') {
+      return 0;
+    }
+
+    let cleaned = value.replace(/[^0-9.-]/g, '');
+
+    const isNegative = cleaned.startsWith('-');
+    cleaned = cleaned.replace(/-/g, '');
+    if (isNegative) cleaned = '-' + cleaned;
+
+    const firstDotIndex = cleaned.indexOf('.');
+    if (firstDotIndex !== -1) {
+      cleaned = cleaned.slice(0, firstDotIndex + 1) + cleaned.slice(firstDotIndex + 1).replace(/\./g, '');
+    }
+
+    const parsed = parseFloat(cleaned);
+    return Number.isFinite(parsed) ? parsed : 0;
+  },
+};
+
+export function transform(
+  value: string,
+  options: {
+    prevValue?: string;
+    textSkipInjectionValidation?: boolean;
+    textRemoveCyrillic?: boolean;
+    textSanitize?: boolean;
+    textDeduplicate?: boolean;
+    textTrim?: boolean;
+    textNoSpaces?: boolean;
+    textUpperCase?: boolean;
+    textCompanyName?: boolean;
+    textNumber?: boolean;
+  },
+) {
+  if (options?.textNumber) return textTransformers.extractNumber(value);
+
+  if (!value) return '';
+
+  let result = value;
+
+  if (options?.textRemoveCyrillic && textTransformers.disableCyrillic) {
+    result = textTransformers.disableCyrillic(result);
+  }
+  if (options?.textSanitize && textTransformers.sanitize) {
+    result = textTransformers.sanitize(result);
+  }
+  if (options?.textDeduplicate && textTransformers.deduplicate) {
+    result = textTransformers.deduplicate(result);
+  }
+  if (options?.textTrim && textTransformers.trim) {
+    result = textTransformers.trim(result);
+  }
+  if (options?.textNoSpaces && textTransformers.noSpaces) {
+    result = textTransformers.noSpaces(result);
+  }
+  if (options?.textUpperCase && textTransformers.upperCase) {
+    result = textTransformers.upperCase(result);
+  }
+
+  return result;
+}

package/platforms/react-native/generators/init/generator.js

@@ -0,0 +1,86 @@
+import { writeSummary } from '../../../../lib/journal.js';
+import { projectRoot } from '../../../../lib/project.js';
+import { isDry } from '../../runtime.js';
+
+const NAVIGATORS = ['react-native-navigation', 'react-navigation', 'expo-router'];
+
+// CLI --navigator is already on data. Otherwise keep the navigator from forge.config.
+let configNavigator = 'react-native-navigation';
+
+function navigatorOf(data) {
+  if (data.navigator === undefined || data.navigator === null || data.navigator === '') {
+    data.navigator = configNavigator;
+  }
+  return data.navigator;
+}
+
+export default {
+  description: 'Copy the React Native FSD src base (auth, profile, app shell, UI kit)',
+  prompts(forge) {
+    configNavigator = forge.config.navigator ?? 'react-native-navigation';
+    return [
+      {
+        type: 'input',
+        name: 'apiUrl',
+        message: 'API base URL:',
+        default: 'https://api.example.com/',
+      },
+    ];
+  },
+  actions: [
+    {
+      type: 'addMany',
+      templateFiles: 'init/files',
+      options: {
+        ignore: ['**/node_modules/**', '**/.git/**', '**/generator.js', '**/navigation/**'],
+      },
+    },
+    {
+      type: 'addMany',
+      templateFiles: 'init/files/navigation',
+      destination: 'navigation',
+      skip: (data) => navigatorOf(data) !== 'react-native-navigation',
+    },
+    {
+      type: 'addMany',
+      templateFiles: 'init/navigators/react-navigation',
+      destination: 'navigation',
+      skip: (data) => navigatorOf(data) !== 'react-navigation',
+    },
+    {
+      type: 'addMany',
+      templateFiles: 'init/navigators/expo-router',
+      destination: 'navigation',
+      skip: (data) => navigatorOf(data) !== 'expo-router',
+    },
+    {
+      type: 'add',
+      path: '../AGENTS.md',
+      templateFile: '../ai/AGENTS.md.hbs',
+      skip: (data) => !NAVIGATORS.includes(navigatorOf(data)),
+    },
+    {
+      type: 'custom',
+      action: async (data, forge) => {
+        const navigator = navigatorOf(data);
+        if (!NAVIGATORS.includes(navigator)) {
+          return { success: false, error: `No navigator stub for ${navigator}` };
+        }
+        const outputDir = forge.resolveOutputDir('rn-fsd:init');
+        const dryRun = isDry(data, forge);
+        await writeSummary(projectRoot(forge), {
+          generator: 'init',
+          lines: [
+            `Copied the FSD base into ${outputDir}`,
+            `Navigator: ${navigator}`,
+            `API_URL: ${data.apiUrl}`,
+            'Next: forge g demo, forge g entity, forge g feature, forge g component, forge g add',
+            'The project catalog of ready-made pieces is node_modules/@effijs/templates/platforms/react-native/CATALOG.md',
+          ],
+          dryRun,
+        });
+        return { success: true };
+      },
+    },
+  ],
+};

package/platforms/react-native/generators/init/kit.js

@@ -0,0 +1,23 @@
+export default {
+  platform: 'react-native',
+  items: [
+    { type: 'component', name: 'Box', description: 'View with theme color, radius, and shadow props.', path: 'ui/components/Box' },
+    { type: 'component', name: 'Grid', description: 'Layout primitive with spacing and alignment props.', path: 'ui/components/Grid' },
+    { type: 'component', name: 'Text', description: 'Themed text with typography props.', path: 'ui/components/Text' },
+    { type: 'component', name: 'Button', description: 'Pressable button. Loading uses ActivityIndicator.', path: 'ui/components/Button' },
+    { type: 'component', name: 'Screen', description: 'Screen shell with header, content, and safe area. Built for Wix navigation.', path: 'ui/components/Screen' },
+    { type: 'component', name: 'Form', description: 'EffiJS form bindings. DateTimePicker, SelectPicker, and InputSecurity are separate solutions.', path: 'ui/components/Form' },
+    { type: 'component', name: 'TextInput', description: 'Themed text input. OTP is a separate solution.', path: 'ui/components/TextInput' },
+    { type: 'component', name: 'Icon', description: 'Icon font glyph.', path: 'ui/components/Icon' },
+    { type: 'component', name: 'Loading', description: 'Loading overlay driven by a small store.', path: 'ui/components/Loading' },
+    { type: 'component', name: 'ThemePicker', description: 'Switches the active theme scheme.', path: 'ui/components/ThemePicker' },
+    { type: 'widget', name: 'toast', description: 'Toast stack shown through navigation.widgets.showToast.', path: 'ui/widgets/toast' },
+    { type: 'service', name: 'http', description: 'HTTP client with token and error middleware.', path: 'services/http' },
+    { type: 'util', name: 'string', description: 'Text transforms used by form inputs.', path: 'utils/string.ts' },
+    { type: 'util', name: 'date', description: 'Date helpers.', path: 'utils/date.ts' },
+    { type: 'util', name: 'store.persistent', description: 'MMKV-backed persistent store.', path: 'utils/store.persistent.ts' },
+    { type: 'entity', name: 'auth', description: 'Session, sign-in, and sign-up entity.', path: 'entity/auth' },
+    { type: 'feature', name: 'auth', description: 'Sign-in and sign-up screens.', path: 'feature/auth' },
+    { type: 'feature', name: 'profile', description: 'Profile screen and theme picker.', path: 'feature/profile' },
+  ],
+};

package/platforms/react-native/generators/init/navigators/expo-router/index.ts

@@ -0,0 +1,18 @@
+import { EffiJS, Entity } from '@effijs/common';
+
+import { NavigationApp } from './navigation.app';
+import { NavigationFeatures } from './navigation.features';
+import { NavigationTabs } from './navigation.tabs';
+import { NavigationWidgets } from './navigation.widgets';
+
+@Entity.Decorators.Module()
+export class Navigation {
+  constructor(
+    public app: NavigationApp,
+    public features: NavigationFeatures,
+    public tabs: NavigationTabs,
+    public widgets: NavigationWidgets,
+  ) {}
+}
+
+EffiJS.create(Navigation, 'Navigation');

package/platforms/react-native/generators/init/navigators/expo-router/navigation.app.ts

@@ -0,0 +1,8 @@
+// TODO: Expo Router app navigator. Replace these methods with expo-router paths.
+
+export class NavigationApp {
+  goToSplash() {}
+  goToOnboarding() {}
+  goToSignIn() {}
+  goToSignUp() {}
+}

package/platforms/react-native/generators/init/navigators/expo-router/navigation.features.ts

@@ -0,0 +1,9 @@
+import { Entity } from '@effijs/common';
+// forge:navigation-features-import
+
+@Entity.Decorators.Feature()
+export class NavigationFeatures {
+  constructor(
+    // forge:navigation-features
+  ) {}
+}

package/platforms/react-native/generators/init/navigators/expo-router/navigation.hooks.ts

@@ -0,0 +1,5 @@
+import { EffiJS } from '@effijs/common';
+
+export function useNavigation() {
+  return EffiJS.resolve<import('./index').Navigation>('Navigation');
+}

package/platforms/react-native/generators/init/navigators/expo-router/navigation.tabs.ts

@@ -0,0 +1,7 @@
+// TODO: Expo Router tabs.
+
+export class NavigationTabs {
+  // forge:navigation-tabs-register
+
+  goToTabs() {}
+}

package/platforms/react-native/generators/init/navigators/expo-router/navigation.widgets.ts

@@ -0,0 +1,5 @@
+// TODO: Expo Router overlays. showToast is called by auth and form services.
+
+export class NavigationWidgets {
+  showToast(_options: { type?: string; title?: string }) {}
+}

package/platforms/react-native/generators/init/navigators/react-navigation/index.ts

@@ -0,0 +1,18 @@
+import { EffiJS, Entity } from '@effijs/common';
+
+import { NavigationApp } from './navigation.app';
+import { NavigationFeatures } from './navigation.features';
+import { NavigationTabs } from './navigation.tabs';
+import { NavigationWidgets } from './navigation.widgets';
+
+@Entity.Decorators.Module()
+export class Navigation {
+  constructor(
+    public app: NavigationApp,
+    public features: NavigationFeatures,
+    public tabs: NavigationTabs,
+    public widgets: NavigationWidgets,
+  ) {}
+}
+
+EffiJS.create(Navigation, 'Navigation');

package/platforms/react-native/generators/init/navigators/react-navigation/navigation.app.ts

@@ -0,0 +1,8 @@
+// TODO: React Navigation app navigator. Replace these methods with a real NavigationContainer setup.
+
+export class NavigationApp {
+  goToSplash() {}
+  goToOnboarding() {}
+  goToSignIn() {}
+  goToSignUp() {}
+}

package/platforms/react-native/generators/init/navigators/react-navigation/navigation.features.ts

@@ -0,0 +1,9 @@
+import { Entity } from '@effijs/common';
+// forge:navigation-features-import
+
+@Entity.Decorators.Feature()
+export class NavigationFeatures {
+  constructor(
+    // forge:navigation-features
+  ) {}
+}

package/platforms/react-native/generators/init/navigators/react-navigation/navigation.hooks.ts

@@ -0,0 +1,5 @@
+import { EffiJS } from '@effijs/common';
+
+export function useNavigation() {
+  return EffiJS.resolve<import('./index').Navigation>('Navigation');
+}

package/platforms/react-native/generators/init/navigators/react-navigation/navigation.tabs.ts

@@ -0,0 +1,7 @@
+// TODO: React Navigation tabs.
+
+export class NavigationTabs {
+  // forge:navigation-tabs-register
+
+  goToTabs() {}
+}

package/platforms/react-native/generators/init/navigators/react-navigation/navigation.widgets.ts

@@ -0,0 +1,5 @@
+// TODO: React Navigation overlays. showToast is called by auth and form services.
+
+export class NavigationWidgets {
+  showToast(_options: { type?: string; title?: string }) {}
+}

package/platforms/react-native/generators/setup/generator.js

@@ -0,0 +1,225 @@
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { TSCONFIG_PATHS, patchTsconfig } from '../../../../lib/jsonConfig.js';
+import { detectNavigator, detectPackageManager, detectReactNativeVersion, projectRoot } from '../../../../lib/project.js';
+import { resolveRange } from '../../../../lib/compat.js';
+import { installPackages } from '../../../../lib/install.js';
+import { dependenciesFor } from '../../compat/matrix.js';
+import { renderForgeConfig } from '../../configs/forgeConfig.js';
+import { patchBabel, patchJest, patchPrettier, patchRnConfig } from '../../configs/jsConfigs.js';
+import { patchIndexJs, patchMetro } from '../../configs/metro.js';
+import platform from '../../platform.js';
+import { isDry, patchText, walkText } from '../../runtime.js';
+import { writeSummary } from '../../../../lib/journal.js';
+
+const NAVIGATORS = platform.navigators.map((item) => item.id);
+
+export default {
+  description: 'Install EffiJS dependencies and patch React Native configs',
+  prompts: (forge) => {
+    const root = projectRoot(forge);
+    return [
+      {
+        type: 'list',
+        name: 'packageManager',
+        message: 'Package manager:',
+        choices: ['yarn', 'npm', 'pnpm'],
+        default: detectPackageManager(root),
+      },
+      {
+        type: 'list',
+        name: 'navigator',
+        message: 'Navigation library:',
+        choices: platform.navigators.map((item) => ({
+          name: item.implemented ? item.title : `${item.title} (stub)`,
+          value: item.id,
+        })),
+        default: detectNavigator(root) ?? 'react-native-navigation',
+      },
+      {
+        type: 'confirm',
+        name: 'moveStarter',
+        message: 'Move App.tsx and App.test.tsx into .forge/backup?',
+        default: true,
+      },
+    ];
+  },
+  actions: [
+    {
+      type: 'custom',
+      action: async (data, forge) => {
+        const root = projectRoot(forge);
+        if (!NAVIGATORS.includes(data.navigator)) {
+          return { success: false, error: `Unknown navigator "${data.navigator}"` };
+        }
+        const version = detectReactNativeVersion(root);
+        if (!version) return { success: false, error: 'react-native was not found in package.json' };
+        const resolved = resolveRange(version, platform.matrix);
+        data.rnVersion = version;
+        data.compat = resolved.entry;
+        data.compatWarning = resolved.warning;
+        if (resolved.warning) console.warn(resolved.warning);
+        return { success: true };
+      },
+    },
+    {
+      type: 'custom',
+      action: async (data, forge) => {
+        const root = projectRoot(forge);
+        const dependencies = dependenciesFor(data.compat, data.navigator);
+        const result = installPackages({
+          root,
+          packageManager: data.packageManager,
+          dependencies,
+          devDependencies: data.compat.devDependencies,
+          dryRun: isDry(data, forge),
+        });
+        data.install = result;
+        return { success: true };
+      },
+    },
+    {
+      type: 'custom',
+      action: async (data, forge) => {
+        const root = projectRoot(forge);
+        const notes = [];
+        if (data.compatWarning) notes.push(data.compatWarning);
+        if (data.install?.command) notes.push(`Dependencies: ${data.install.command}`);
+        if (data.install?.merged) notes.push('Install failed; package.json was updated for a manual install.');
+
+        const nvm = path.join(root, '.nvmrc');
+        const nvmResult = await patchText(forge, nvm, async (content, { exists }) => {
+          const current = content.trim();
+          if (exists && current !== data.compat.node) {
+            notes.push(`.nvmrc ${current} -> ${data.compat.node}`);
+          }
+          return { ok: true, content: `${data.compat.node}\n` };
+        }, { title: 'Update .nvmrc', manual: `Write \`${data.compat.node}\` to .nvmrc.` });
+        if (!nvmResult.ok && !nvmResult.migration && !isDry(data, forge)) notes.push(`nvmrc: ${nvmResult.reason}`);
+
+        await patchConfig(forge, data, notes, 'tsconfig.json', (file, content, ctx) => {
+          if (!ctx.exists) return { ok: false, reason: 'tsconfig.json was not found.' };
+          return { ok: true, content: patchTsconfig(content, { paths: TSCONFIG_PATHS, types: ['jest'], exclude: ['**/node_modules', '**/Pods', 'backup/**'] }) };
+        }, 'Add decorator flags and path aliases to tsconfig.json.');
+
+        await patchConfig(forge, data, notes, 'babel.config.js', (file, content, ctx) => patchBabel(file, content, { ...ctx, lastPlugin: data.compat.babelPluginLast }), 'Merge decorators, module-resolver, and the worklets or reanimated plugin. The last plugin must stay last.');
+        await patchConfig(forge, data, notes, 'jest.config.js', (file, content, ctx) => patchJest(file, content, ctx), 'Set the React Native Jest preset and ignore /backup/.');
+        await patchConfig(forge, data, notes, '.prettierrc.js', (file, content, ctx) => patchPrettier(file, content, ctx), 'Merge the EffiJS Prettier defaults.');
+        await patchConfig(forge, data, notes, 'react-native.config.js', (file, content, ctx) => patchRnConfig(file, content, ctx), 'Point assets at ./src/ui/fonts/.');
+
+        if (data.linkLocal) {
+          await patchConfig(forge, data, notes, 'metro.config.js', (file, content, ctx) => patchMetro(content, { ...ctx, linkLocal: data.linkLocal }), 'Add watchFolders and extraNodeModules for the local EffiJS checkout.');
+        }
+
+        await patchConfig(forge, data, notes, 'index.js', (file, content, ctx) => patchIndexJs(content, ctx), "Replace the AppRegistry bootstrap with `import './src';`.");
+
+        const forgeFile = path.join(root, 'forge.config.js');
+        await patchText(forge, forgeFile, async () => ({
+          ok: true,
+          content: renderForgeConfig({ packageManager: data.packageManager, navigator: data.navigator }),
+        }), {
+          title: 'Write forge.config.js',
+          manual: 'Write the canonical forge.config.js from the platform setup guide.',
+        });
+        notes.push('forge.config.js points at the rn-fsd preset with an absolute directory from require.resolve.');
+
+        if (data.moveStarter) {
+          for (const relative of ['App.tsx', '__tests__/App.test.tsx']) {
+            const from = path.join(root, relative);
+            if (!fs.existsSync(from)) continue;
+            const dest = path.join(root, '.forge/backup', path.basename(relative));
+            if (!isDry(data, forge)) {
+              fs.mkdirSync(path.dirname(dest), { recursive: true });
+              fs.renameSync(from, dest);
+            }
+            notes.push(`Moved ${relative} to .forge/backup/`);
+          }
+        }
+
+        if (data.navigator === 'react-native-navigation') {
+          const linked = await linkWix(root, data.compat, isDry(data, forge));
+          if (linked.ok) notes.push('rnn-link passed the native marker check.');
+          else {
+            notes.push(`Native navigation still needs a manual step: ${(linked.missing ?? []).join(', ') || linked.reason}`);
+            if (!isDry(data, forge)) {
+              const file = await writeNativeMigration(root, data.compat, linked);
+              notes.push(`Migration: ${file}`);
+            }
+          }
+        } else {
+          notes.push(`${data.navigator} is a stub. init will generate TODO navigation classes.`);
+        }
+
+        data.summaryNotes = notes;
+        const summary = await writeSummary(root, {
+          generator: 'setup',
+          lines: notes,
+          dryRun: isDry(data, forge),
+        });
+        if (summary) {
+          const migrations = path.join(root, '.forge/migrations');
+          if (fs.existsSync(migrations) && fs.readdirSync(migrations).length) {
+            console.log('Apply `.forge/migrations/<file>.md` following `node_modules/@effijs/templates/platforms/react-native/ai/SETUP.md`.');
+          }
+        }
+        return { success: true };
+      },
+    },
+  ],
+};
+
+async function patchConfig(forge, data, notes, relative, transform, manual) {
+  const file = path.join(projectRoot(forge), relative);
+  const result = await patchText(forge, file, async (content, ctx) => transform(file, content, ctx), {
+    title: `Update ${relative}`,
+    manual,
+  });
+  if (result.migration) notes.push(`Migration for ${relative}`);
+  else if (result.changed) notes.push(`Patched ${relative}`);
+  else if (result.ok) notes.push(`${relative} already matched or was left unchanged`);
+  return result;
+}
+
+async function linkWix(root, entry, dryRun) {
+  if (dryRun) return { ok: true, dryRun: true };
+  try {
+    execSync('npx rnn-link', { cwd: root, stdio: 'inherit' });
+  } catch (error) {
+    return { ok: false, reason: error.message, missing: ['NavigationActivity', 'NavigationApplication', 'RNNAppDelegate'] };
+  }
+  const android = walkText(path.join(root, 'android'), (name) => name.endsWith('.kt') || name.endsWith('.java'));
+  const ios = walkText(path.join(root, 'ios'), (name) => name.endsWith('.swift') || name.endsWith('.mm') || name.endsWith('.m'));
+  const missing = [];
+  if (!android.includes('NavigationActivity')) missing.push('NavigationActivity');
+  if (!android.includes('NavigationApplication')) missing.push('NavigationApplication');
+  if (!ios.includes('RNNAppDelegate')) missing.push('RNNAppDelegate');
+  return { ok: missing.length === 0, missing, native: entry.native };
+}
+
+async function writeNativeMigration(root, entry, linked) {
+  const { writeMigration, aiPrompt } = await import('../../../../lib/migration.js');
+  return writeMigration(root, {
+    title: 'Link React Native Navigation',
+    target: 'ios + android',
+    reason: linked.reason
+      ? `npx rnn-link failed: ${linked.reason}`
+      : `Native files are missing: ${linked.missing.join(', ')}. Android snippets come from the React Native Navigation install guide and must be checked against this project's Kotlin template. The iOS AppDelegate matches the EffiJS example.`,
+    required: [
+      '### AppDelegate.swift',
+      '```swift',
+      entry.native.iosAppDelegate.trim(),
+      '```',
+      '### MainActivity.kt',
+      '```kotlin',
+      entry.native.androidMainActivity.trim(),
+      '```',
+      '### MainApplication.kt',
+      '```kotlin',
+      entry.native.androidMainApplication.trim(),
+      '```',
+    ].join('\n'),
+    prompt: aiPrompt('.forge/migrations/<this-file>'),
+  });
+}

package/platforms/react-native/generators/util/generator.js

@@ -0,0 +1,12 @@
+import { addPrompts, runAdd } from '../add/run.js';
+
+export default {
+  description: 'Install a shared utility',
+  prompts: addPrompts('util'),
+  actions: [
+    {
+      type: 'custom',
+      action: (data, forge) => runAdd(data, forge, 'util'),
+    },
+  ],
+};

package/platforms/react-native/platform.js

@@ -0,0 +1,32 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { matrix } from './compat/matrix.js';
+
+const root = path.dirname(fileURLToPath(import.meta.url));
+
+const platform = {
+  id: 'react-native',
+  preset: 'rn-fsd',
+  root,
+  matrix,
+  navigators: [
+    { id: 'react-native-navigation', title: 'Wix React Native Navigation', implemented: true },
+    { id: 'react-navigation', title: 'React Navigation', implemented: false },
+    { id: 'expo-router', title: 'Expo Router', implemented: false },
+  ],
+  markers: {
+    entity: 'entity',
+    feature: 'feature',
+    navigationFeaturesImport: 'navigation-features-import',
+    navigationFeatures: 'navigation-features',
+    navigationTabs: 'navigation-tabs',
+    navigationTabsRegister: 'navigation-tabs-register',
+    componentsImport: 'components-import',
+    componentsExport: 'components-export',
+    services: 'services',
+    utils: 'utils',
+  },
+};
+
+export default platform;

package/platforms/react-native/runtime.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { applyTextPatch } from '../../lib/patch.js';
+import { aiPrompt, writeMigration } from '../../lib/migration.js';
+import { projectRoot } from '../../lib/project.js';
+
+export function isDry(data, forge) {
+  return Boolean(data.dryRun || forge?.runOptions?.dryRun);
+}
+
+export function srcDir(forge) {
+  return forge.resolveOutputDir('rn-fsd:init');
+}
+
+export async function patchText(forge, file, transform, { title, manual }) {
+  const root = projectRoot(forge);
+  const dryRun = Boolean(forge.runOptions?.dryRun);
+  const result = await applyTextPatch(root, file, transform, { dryRun });
+  if (result.ok) return result;
+  if (dryRun) {
+    console.log(`[dry-run] Would write a migration for ${file}: ${result.reason}`);
+    return result;
+  }
+  const relative = path.relative(root, file);
+  const migration = await writeMigration(root, {
+    title: title ?? `Update ${relative}`,
+    target: relative,
+    reason: result.reason,
+    required: manual ?? 'See the platform setup guide for the canonical snippet.',
+    prompt: aiPrompt(`.forge/migrations/<this-file>`),
+  });
+  console.warn(`Migration written: ${migration}`);
+  return { ...result, migration };
+}
+
+export function assertInit(outputDir) {
+  const markerFile = path.join(outputDir, 'entity/index.ts');
+  if (!fs.existsSync(markerFile)) return false;
+  return fs.readFileSync(markerFile, 'utf8').includes('// forge:entity');
+}
+
+export function walkText(dir, matcher) {
+  if (!fs.existsSync(dir)) return '';
+  let blob = '';
+  const stack = [dir];
+  while (stack.length) {
+    const current = stack.pop();
+    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+      if (entry.name === 'node_modules' || entry.name === 'Pods' || entry.name === 'build') continue;
+      const next = path.join(current, entry.name);
+      if (entry.isDirectory()) stack.push(next);
+      else if (matcher(entry.name)) blob += fs.readFileSync(next, 'utf8');
+    }
+  }
+  return blob;
+}