@codemoreira/esad 1.0.1 → 1.1.0

package/README.md

@@ -11,31 +11,31 @@ ESAD is a unified toolkit designed to abstract all the complexity from Super App
 ### 1. Initialize a Workspace
 Creates a main project folder with a Host (Expo-ready) and a global configuration.
 ```bash
-npx esad init nome-do-projeto
+npx @codemoreira/esad init my-project
 ```
 
 ### 2. Create a Federated Module
 Scaffolds a new mini-app correctly named and configured to join the Super App.
 ```bash
-esad create-module modulo-rh
+npx esad create-module module-rh
 ```
 
 ### 3. Create a Service Registry / CDN
 Sets up the backend registry used for dynamic routing and file hosting.
 ```bash
-esad create-cdn
+npx esad create-cdn
 ```
 
 ### 4. Development Mode (Real-time HMR)
 Starts the local packager and **automatically** notifies the Registry to bypass the CDN, so your Host App sees your local changes instantly.
 ```bash
-esad dev --id modulo-rh --port 8081
+npx esad dev --id module-rh --port 8081
 ```
 
 ### 5. Deployment
 Builds, zips, and uploads the module bundle to the configured CDN endpoint.
 ```bash
-esad deploy --id modulo-rh --version 1.0.0 --entry index.bundle
+npx esad deploy --id module-rh --version 1.0.0 --entry index.bundle
 ```
 
 ---
@@ -49,7 +49,7 @@ import { withESAD } from 'esad/plugin';
 
 export default withESAD({
   type: 'module', // or 'host'
-  id: 'meu-mini-app'
+  id: 'my-mini-app'
 });
 ```
 
@@ -63,17 +63,12 @@ const [token, setToken] = useESADState('auth_token');
 
 ---
 
-## 📦 Publishing Updates
+## 🏠 Host App Features (by Default)
 
-Whenever you make changes to the **ESAD** source code (CLI or Lib), follow these steps to push a new version to NPM:
+When you run `esad init`, the generated Host App comes pre-configured with:
 
-1. **Bump the version**:
-   Open `package.json` and increase the version number (e.g., `1.0.0` to `1.0.1`).
-   *Tip: Use `npm version patch` in the terminal to do this automatically.*
-
-2. **Publish**:
-   ```bash
-   npm publish
-   ```
-
-Clients already using ESAD can then run `npm update esad` to get your latest improvements!
+- **🎨 NativeWind v4**: Utility-first styling ready to use with Tailwind CSS logic.
+- **🔐 Auth System**: Complete `AuthProvider` with persistent token storage using `expo-secure-store`.
+- **🛤️ Protected Routes**: Automatic redirection between `login` and `(protected)` groups based on auth state.
+- **📦 Module Loader**: A robust `lib/moduleLoader.ts` to fetch and initialize federated modules dynamically.
+- **📱 Premium UI**: A clean, modern starting point for your Super App dashboard.

package/bin/esad.js

@@ -1,149 +1,35 @@
 #!/usr/bin/env node
 
 const { program } = require('commander');
-const fs = require('fs-extra');
-const path = require('path');
-const { spawn } = require('cross-spawn');
-const AdmZip = require('adm-zip');
+
+// Import Commands
+const initCommand = require('../src/cli/commands/init');
+const createModuleCommand = require('../src/cli/commands/createModule');
+const createCdnCommand = require('../src/cli/commands/createCdn');
+const deployCommand = require('../src/cli/commands/deploy');
+const devCommand = require('../src/cli/commands/dev');
 
 program
-  .version('1.0.0')
+  .version('1.1.0')
   .description('esad - Easy Super App Development Toolkit');
 
-// Helper to spawn commands synchronously
-const runProcess = (cmd, args, cwd = process.cwd()) => {
-  return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, { stdio: 'inherit', cwd, shell: true });
-    child.on('close', code => {
-      if (code !== 0) reject(new Error(`Command ${cmd} ${args.join(' ')} failed`));
-      else resolve();
-    });
-  });
-};
-
-const getWorkspaceConfig = () => {
-  let configPath = path.join(process.cwd(), 'esad.config.json');
-  if (!fs.existsSync(configPath)) configPath = path.join(process.cwd(), '../esad.config.json');
-  if (!fs.existsSync(configPath)) return null;
-  return { path: configPath, data: fs.readJsonSync(configPath) };
-};
-
 // --- COMMMAND: esad init ---
 program
   .command('init <project-name>')
   .description('Scaffold a new ESAD workspace containing the Host App')
-  .action(async (projectName) => {
-    const workspaceDir = path.join(process.cwd(), projectName);
-    console.log(`\n🚀 Initializing ESAD Workspace: ${projectName}...\n`);
-    
-    // Create Workspace Dir
-    fs.ensureDirSync(workspaceDir);
-
-    // Create base esad.config.json at root workspace
-    const configPath = path.join(workspaceDir, 'esad.config.json');
-    if (!fs.existsSync(configPath)) {
-      const configTemplate = {
-        projectName: projectName,
-        registryUrl: "http://localhost:3000/modules",
-        deployEndpoint: "http://localhost:3000/api/admin/modules/{{moduleId}}/versions",
-        devModeEndpoint: "http://localhost:3000/api/admin/modules/{{moduleId}}"
-      };
-      fs.writeJsonSync(configPath, configTemplate, { spaces: 2 });
-      console.log(`✅ Generated dynamic configuration file: esad.config.json`);
-    }
-
-    // Create .gitignore to allow only host and config (Poly-repo support)
-    const gitignorePath = path.join(workspaceDir, '.gitignore');
-    if (!fs.existsSync(gitignorePath)) {
-      const hostName = `${projectName}-host`;
-      const gitignoreContent = `# ESAD Workspace Git Configuration\n` +
-        `# Ignore everything by default\n` +
-        `/*\n\n` +
-        `# Exceptions: Track only the Host and Configs\n` +
-        `!/${hostName}/\n` +
-        `!/esad.config.json\n` +
-        `!/.gitignore\n` +
-        `\n# Ignore node_modules\n` +
-        `node_modules/\n`;
-      fs.writeFileSync(gitignorePath, gitignoreContent);
-      console.log(`✅ Generated .gitignore (Whitelist mode: ignored modules so they can have their own repos)`);
-    }
-
-    // Scaffold Expo app using create-expo-app
-    const hostName = `${projectName}-host`;
-    const hostDir = path.join(workspaceDir, hostName);
-    
-    try {
-      console.log(`\n📦 Scaffolding clean Expo project: ${hostName}...`);
-      await runProcess('npx', ['create-expo-app', hostName, '--template', 'blank'], workspaceDir);
-      
-      console.log(`\n📦 Installing ESAD dependencies into host...`);
-      // Simulate local ESAD package link (in reality it would be an npm publish fetch)
-      await runProcess('npm', ['install', '../../esad'], hostDir); 
-
-      // Generate the Host's rspack config using withESAD
-      const rspackContent = `import { withESAD } from 'esad/plugin';\n\nexport default withESAD({\n  type: 'host',\n  id: '${hostName}'\n});\n`;
-      fs.writeFileSync(path.join(hostDir, 'rspack.config.mjs'), rspackContent);
-      console.log(`✅ Injected withESAD wrapper into rspack.config.mjs`);
-
-      console.log(`\n🎉 ESAD Workpace Initialized!`);
-      console.log(`-> cd ${projectName}\n-> esad create-cdn\n-> esad create-module modulo1`);
-    } catch (err) {
-      console.error(`❌ Failed to init Host:`, err.message);
-    }
-  });
+  .action(initCommand);
 
 // --- COMMAND: esad create-cdn ---
 program
   .command('create-cdn [cdn-name]')
   .description('Scaffold the CDN / Registry backend')
-  .action(async (cdnName) => {
-    const configObj = getWorkspaceConfig();
-    if (!configObj) {
-      console.error(`❌ Error: Call this command from inside an ESAD workspace (esad.config.json not found).`);
-      return;
-    }
-    const finalCdnName = cdnName || `${configObj.data.projectName}-cdn`;
-    console.log(`\n📦 Creating CDN Registry: ${finalCdnName}...\n`);
-    // Placeholder for backend cloning
-    console.log(`[TODO] Scaffold Node Express backend into ./${finalCdnName}`);
-  });
+  .action(createCdnCommand);
 
 // --- COMMAND: esad create-module ---
 program
   .command('create-module <module-name>')
   .description('Scaffold a React Native mini-app automatically configured for Module Federation via ESAD')
-  .action(async (moduleName) => {
-    const configObj = getWorkspaceConfig();
-    if (!configObj) {
-      console.error(`❌ Error: Call this command from inside an ESAD workspace (esad.config.json not found).`);
-      return;
-    }
-
-    const { projectName } = configObj.data;
-    const isPrefixed = moduleName.startsWith(`${projectName}-`);
-    const finalModuleName = isPrefixed ? moduleName : `${projectName}-${moduleName}`;
-    
-    const workspaceDir = path.dirname(configObj.path);
-    const targetDir = path.join(workspaceDir, finalModuleName);
-
-    console.log(`\n📦 Creating federated mini-app: ${finalModuleName}...\n`);
-    
-    try {
-      await runProcess('npx', ['react-native@latest', 'init', finalModuleName], workspaceDir);
-      console.log(`\n📦 Installing ESAD dependencies...`);
-      // Simulate local link
-      await runProcess('npm', ['install', '../../esad'], targetDir);
-
-      const rspackContent = `import { withESAD } from 'esad/plugin';\n\nexport default withESAD({\n  type: 'module',\n  id: '${finalModuleName}'\n});\n`;
-      fs.writeFileSync(path.join(targetDir, 'rspack.config.mjs'), rspackContent);
-      console.log(`✅ Injected withESAD wrapper into rspack.config.mjs`);
-
-      console.log(`\n🎉 Module ${finalModuleName} is ready!`);
-    } catch (err) {
-      console.error(`❌ Failed to scaffold module`, err.message);
-    }
-  });
+  .action(createModuleCommand);
 
 // --- COMMAND: esad deploy ---
 program
@@ -152,43 +38,7 @@ program
   .requiredOption('-i, --id <moduleId>', 'The Module ID to deploy')
   .requiredOption('-e, --entry <entryFileName>', 'The name of the main entry bundle (e.g., index.bundle)')
   .description('Zips the local dist directory and uploads it to the configured deployment endpoint')
-  .action(async (options) => {
-    console.log(`\n☁️  Starting ESAD Deploy for ${options.id} (v${options.version})\n`);
-    
-    const configObj = getWorkspaceConfig();
-    if (!configObj) {
-      console.error(`❌ Error: esad.config.json not found in current directory or parent.`);
-      process.exit(1);
-    }
-
-    const config = configObj.data;
-    if (!config.deployEndpoint) {
-      console.error(`❌ Error: 'deployEndpoint' not configured in esad.config.json.`);
-      process.exit(1);
-    }
-    
-    const deployUrl = config.deployEndpoint.replace('{{moduleId}}', options.id);
-    console.log(`📡 Deployment Endpoint Resolved: ${deployUrl}`);
-    
-    const distPath = path.join(process.cwd(), 'dist');
-    if (!fs.existsSync(distPath)) {
-      console.error(`❌ Error: dist/ directory not found. Did you run the build command?`);
-      process.exit(1);
-    }
-
-    const zip = new AdmZip();
-    zip.addLocalFolder(distPath);
-    
-    const zipPath = path.join(process.cwd(), `bundle-${options.id}-${options.version}.zip`);
-    zip.writeZip(zipPath);
-    console.log(`🗜️  Zipped output to ${zipPath}`);
-
-    console.log(`🚀 Uploading to CDN via multipart POST...`);
-    // Example fetch upload would go here
-    
-    console.log(`✅ [SIMULATED] Successfully uploaded to ${deployUrl}`);
-    fs.unlinkSync(zipPath);
-  });
+  .action(deployCommand);
 
 // --- COMMAND: esad dev ---
 program
@@ -196,38 +46,6 @@ program
   .requiredOption('-i, --id <moduleId>', 'The Module ID to run in dev mode')
   .option('-p, --port <port>', 'The port to run the dev server on', '8081')
   .description('Starts the dev server and updates the external registry to bypass CDN')
-  .action(async (options) => {
-    console.log(`\n⚡ Starting ESAD Dev Server for ${options.id} on port ${options.port}...\n`);
-    
-    const configObj = getWorkspaceConfig();
-    const config = configObj ? configObj.data : null;
-    let devApiUrl = config?.devModeEndpoint ? config.devModeEndpoint.replace('{{moduleId}}', options.id) : null;
-
-    const setDevMode = async (isActive) => {
-      if (!devApiUrl) return;
-      try {
-        const body = { 
-          is_dev_mode: isActive, 
-          ...(isActive && { dev_url: `http://localhost:${options.port}/index.bundle` }) 
-        };
-        const res = await fetch(devApiUrl, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
-        if (res.ok) console.log(`📡 Registry Sync: Dev Override is ${isActive ? 'ON' : 'OFF'} para o modulo Host`);
-      } catch(e) { /* ignore */ }
-    };
-
-    await setDevMode(true);
-
-    const proc = spawn('npx', ['react-native', 'webpack-start', '--port', options.port], { stdio: 'inherit', shell: true });
-
-    const shutdown = async () => {
-      console.log(`\n🛑 Parando ESAD Dev Server e revertendo o registro na CDN...`);
-      await setDevMode(false);
-      proc.kill();
-      process.exit(0);
-    };
-
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
-  });
+  .action(devCommand);
 
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemoreira/esad",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Easy Super App Development - Zero-Config CLI and DevTools for React Native Module Federation",
   "main": "src/plugin/index.js",
   "exports": {

package/src/cli/commands/createCdn.js

@@ -0,0 +1,13 @@
+const { getWorkspaceConfig } = require('../utils/config');
+
+module.exports = async (cdnName) => {
+  const configObj = getWorkspaceConfig();
+  if (!configObj) {
+    console.error(`❌ Error: Call this command from inside an ESAD workspace (esad.config.json not found).`);
+    return;
+  }
+  const finalCdnName = cdnName || `${configObj.data.projectName}-cdn`;
+  console.log(`\n📦 Creating CDN Registry: ${finalCdnName}...\n`);
+  // Placeholder for backend cloning
+  console.log(`[TODO] Scaffold Node Express backend into ./${finalCdnName}`);
+};

package/src/cli/commands/createModule.js

@@ -0,0 +1,36 @@
+const fs = require('fs-extra');
+const path = require('path');
+const { runProcess } = require('../utils/process');
+const { getWorkspaceConfig } = require('../utils/config');
+
+module.exports = async (moduleName) => {
+  const configObj = getWorkspaceConfig();
+  if (!configObj) {
+    console.error(`❌ Error: Call this command from inside an ESAD workspace (esad.config.json not found).`);
+    return;
+  }
+
+  const { projectName } = configObj.data;
+  const isPrefixed = moduleName.startsWith(`${projectName}-`);
+  const finalModuleName = isPrefixed ? moduleName : `${projectName}-\${moduleName}`;
+  
+  const workspaceDir = path.dirname(configObj.path);
+  const targetDir = path.join(workspaceDir, finalModuleName);
+
+  console.log(`\n📦 Creating federated mini-app: ${finalModuleName}...\n`);
+  
+  try {
+    await runProcess('npx', ['react-native@latest', 'init', finalModuleName], workspaceDir);
+    console.log(`\n📦 Installing ESAD dependencies...`);
+    // Note: Assuming local link or npm install depends on final workflow
+    await runProcess('npm', ['install', '@codemoreira/esad'], targetDir);
+
+    const rspackContent = `import { withESAD } from '@codemoreira/esad/plugin';\n\nexport default withESAD({\n  type: 'module',\n  id: '${finalModuleName}'\n});\n`
+    fs.writeFileSync(path.join(targetDir, 'rspack.config.mjs'), rspackContent);
+    console.log(`✅ Injected withESAD wrapper into rspack.config.mjs`);
+
+    console.log(`\n🎉 Module ${finalModuleName} is ready!`);
+  } catch (err) {
+    console.error(`❌ Failed to scaffold module`, err.message);
+  }
+};

package/src/cli/commands/deploy.js

@@ -0,0 +1,42 @@
+const fs = require('fs-extra');
+const path = require('path');
+const AdmZip = require('adm-zip');
+const { getWorkspaceConfig } = require('../utils/config');
+
+module.exports = async (options) => {
+  console.log(`\n☁️  Starting ESAD Deploy for ${options.id} (v${options.version})\n`);
+  
+  const configObj = getWorkspaceConfig();
+  if (!configObj) {
+    console.error(`❌ Error: esad.config.json not found in current directory or parent.`);
+    process.exit(1);
+  }
+
+  const config = configObj.data;
+  if (!config.deployEndpoint) {
+    console.error(`❌ Error: 'deployEndpoint' not configured in esad.config.json.`);
+    process.exit(1);
+  }
+  
+  const deployUrl = config.deployEndpoint.replace('{{moduleId}}', options.id);
+  console.log(`📡 Deployment Endpoint Resolved: ${deployUrl}`);
+  
+  const distPath = path.join(process.cwd(), 'dist');
+  if (!fs.existsSync(distPath)) {
+    console.error(`❌ Error: dist/ directory not found. Did you run the build command?`);
+    process.exit(1);
+  }
+
+  const zip = new AdmZip();
+  zip.addLocalFolder(distPath);
+  
+  const zipPath = path.join(process.cwd(), `bundle-${options.id}-${options.version}.zip`);
+  zip.writeZip(zipPath);
+  console.log(`🗜️  Zipped output to ${zipPath}`);
+
+  console.log(`🚀 Uploading to CDN via multipart POST...`);
+  // Example fetch upload would go here
+  
+  console.log(`✅ [SIMULATED] Successfully uploaded to ${deployUrl}`);
+  fs.unlinkSync(zipPath);
+};

package/src/cli/commands/dev.js

@@ -0,0 +1,36 @@
+const { spawn } = require('cross-spawn');
+const { getWorkspaceConfig } = require('../utils/config');
+
+module.exports = async (options) => {
+  console.log(`\n⚡ Starting ESAD Dev Server for ${options.id} on port ${options.port}...\n`);
+  
+  const configObj = getWorkspaceConfig();
+  const config = configObj ? configObj.data : null;
+  let devApiUrl = config?.devModeEndpoint ? config.devModeEndpoint.replace('{{moduleId}}', options.id) : null;
+
+  const setDevMode = async (isActive) => {
+    if (!devApiUrl) return;
+    try {
+      const body = { 
+        is_dev_mode: isActive, 
+        ...(isActive && { dev_url: `http://localhost:${options.port}/index.bundle` }) 
+      };
+      const res = await fetch(devApiUrl, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
+      if (res.ok) console.log(`📡 Registry Sync: Dev Override is ${isActive ? 'ON' : 'OFF'} para o modulo Host`);
+    } catch(e) { /* ignore */ }
+  };
+
+  await setDevMode(true);
+
+  const proc = spawn('npx', ['react-native', 'webpack-start', '--port', options.port], { stdio: 'inherit', shell: true });
+
+  const shutdown = async () => {
+    console.log(`\n🛑 Parando ESAD Dev Server e revertendo o registro na CDN...`);
+    await setDevMode(false);
+    proc.kill();
+    process.exit(0);
+  };
+
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+};

package/src/cli/commands/init.js

@@ -0,0 +1,88 @@
+const fs = require('fs-extra');
+const path = require('path');
+const { runProcess } = require('../utils/process');
+const templates = require('../templates/host');
+
+module.exports = async (projectName) => {
+  const workspaceDir = path.join(process.cwd(), projectName);
+  console.log(`\n🚀 Initializing ESAD Workspace: ${projectName}...\n`);
+  
+  fs.ensureDirSync(workspaceDir);
+
+  const configPath = path.join(workspaceDir, 'esad.config.json');
+  if (!fs.existsSync(configPath)) {
+    const configTemplate = {
+      projectName: projectName,
+      registryUrl: "http://localhost:3000/modules",
+      deployEndpoint: "http://localhost:3000/api/admin/modules/{{moduleId}}/versions",
+      devModeEndpoint: "http://localhost:3000/api/admin/modules/{{moduleId}}"
+    };
+    fs.writeJsonSync(configPath, configTemplate, { spaces: 2 });
+    console.log(`✅ Generated dynamic configuration file: esad.config.json`);
+  }
+
+  const gitignorePath = path.join(workspaceDir, '.gitignore');
+  if (!fs.existsSync(gitignorePath)) {
+    const hostName = `${projectName}-host`;
+    const gitignoreContent = `# ESAD Workspace Git Configuration\n` +
+      `# Ignore everything by default\n` +
+      `/*\n\n` +
+      `# Exceptions: Track only the Host and Configs\n` +
+      `!/${hostName}/\n` +
+      `!/esad.config.json\n` +
+      `!/.gitignore\n` +
+      `\n# Ignore node_modules\n` +
+      `node_modules/\n`;
+    fs.writeFileSync(gitignorePath, gitignoreContent);
+    console.log(`✅ Generated .gitignore`);
+  }
+
+  const hostName = `${projectName}-host`;
+  const hostDir = path.join(workspaceDir, hostName);
+  
+  try {
+    console.log(`\n📦 Scaffolding clean Expo project: ${hostName}...`);
+    await runProcess('npx', ['create-expo-app', hostName, '--template', 'blank'], workspaceDir);
+    
+    console.log(`\n📦 Installing ESAD and UI dependencies into host...`);
+    const deps = [
+      '@codemoreira/esad',
+      'nativewind',
+      'tailwindcss',
+      'postcss',
+      'autoprefixer',
+      'expo-secure-store',
+      'react-native-reanimated',
+      'react-native-safe-area-context',
+      'react-native-screens',
+      'expo-router'
+    ];
+    await runProcess('npm', ['install', ...deps], hostDir); 
+
+    console.log(`\n🎨 Configuring NativeWind & Tailwind...`);
+    fs.writeFileSync(path.join(hostDir, 'tailwind.config.js'), templates.tailwindConfig);
+    fs.writeFileSync(path.join(hostDir, 'babel.config.js'), templates.babelConfig);
+
+    const rspackContent = `import { withESAD } from '@codemoreira/esad/plugin';\n\nexport default withESAD({\n  type: 'host',\n  id: '${hostName}'\n});\n`
+    fs.writeFileSync(path.join(hostDir, 'rspack.config.mjs'), rspackContent);
+
+    console.log(`\n🔐 Scaffolding Auth & Navigation...`);
+    fs.ensureDirSync(path.join(hostDir, 'providers'));
+    fs.ensureDirSync(path.join(hostDir, 'hooks'));
+    fs.ensureDirSync(path.join(hostDir, 'lib'));
+    fs.ensureDirSync(path.join(hostDir, 'app', '(protected)', 'module'));
+
+    fs.writeFileSync(path.join(hostDir, 'providers/auth.tsx'), templates.authProvider);
+    fs.writeFileSync(path.join(hostDir, 'app/_layout.tsx'), templates.rootLayout);
+    fs.writeFileSync(path.join(hostDir, 'app/login.tsx'), templates.loginPage);
+    fs.writeFileSync(path.join(hostDir, 'app/global.css'), templates.globalCss);
+    fs.writeFileSync(path.join(hostDir, 'lib/moduleLoader.ts'), templates.moduleLoader);
+    fs.writeFileSync(path.join(hostDir, 'app/(protected)/index.tsx'), templates.dashboard);
+    fs.writeFileSync(path.join(hostDir, 'app/(protected)/module/[id].tsx'), templates.modulePage);
+
+    console.log(`\n🎉 ESAD Workpace Initialized!`);
+    console.log(`-> cd ${projectName}\n-> esad dev (to start Host)`);
+  } catch (err) {
+    console.error(`❌ Failed to init Host:`, err.message);
+  }
+};

package/src/cli/templates/host.js

@@ -0,0 +1,199 @@
+module.exports = {
+  tailwindConfig: `/** @type {import('tailwindcss').Config} */
+module.exports = {
+  content: ["./app/**/*.{js,jsx,ts,tsx}", "./components/**/*.{js,jsx,ts,tsx}", "./lib/**/*.{js,jsx,ts,tsx}"],
+  presets: [require("nativewind/preset")],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};`,
+
+  babelConfig: `module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: [
+      ["babel-preset-expo", { jsxImportSource: "nativewind" }],
+      "nativewind/babel",
+    ],
+  };
+};`,
+
+  authProvider: `import { createContext, useEffect, useState, useContext } from "react";
+import * as SecureStore from "expo-secure-store";
+
+const AuthContext = createContext({});
+
+export function AuthProvider({ children }) {
+    const [token, setToken] = useState(null);
+    const [isInitialized, setIsInitialized] = useState(false);
+
+    useEffect(() => {
+        SecureStore.getItemAsync("token").then((val) => {
+            setToken(val);
+            setIsInitialized(true);
+        });
+    }, []);
+
+    const login = (mockToken = "session_token") => {
+        setToken(mockToken);
+        SecureStore.setItemAsync("token", mockToken);
+    };
+
+    const logout = () => {
+        setToken(null);
+        SecureStore.deleteItemAsync("token");
+    };
+
+    return (
+        <AuthContext.Provider value={{ token, login, logout, isInitialized }}>
+            {children}
+        </AuthContext.Provider>
+    );
+}
+
+export const useAuth = () => useContext(AuthContext);`,
+
+  rootLayout: `import { Stack, router } from "expo-router";
+import { useEffect } from "react";
+import { AuthProvider, useAuth } from "@/providers/auth";
+import { SafeAreaProvider } from "react-native-safe-area-context";
+import "./global.css";
+
+export default function RootLayout() {
+  return (
+    <SafeAreaProvider>
+      <AuthProvider>
+         <RootNavigation />
+      </AuthProvider>\n    </SafeAreaProvider>
+  );
+}
+
+function RootNavigation() {
+  const { token, isInitialized } = useAuth();
+
+  useEffect(() => {
+    if (!isInitialized) return;\n\n    // Global SuperApp Registry
+    globalThis.__SUPERAPP__ = {
+       getToken: () => token,
+       navigate: (route, params) => router.push({ pathname: route, params })
+    };\n  }, [isInitialized, token]);
+
+  if (!isInitialized) return null;
+
+  return (
+    <Stack screenOptions={{ headerShown: false }}>
+       <Stack.Screen name="login" redirect={!!token} />
+       <Stack.Screen name="(protected)" redirect={!token} />
+    </Stack>
+  );
+}`,
+
+  loginPage: `import { View, Text, TouchableOpacity } from "react-native";
+import { useAuth } from "@/providers/auth";
+
+export default function LoginPage() {
+  const { login } = useAuth();
+
+  return (
+    <View className="flex-1 items-center justify-center bg-slate-50 p-6">
+      <View className="w-full max-w-sm bg-white p-8 rounded-3xl shadow-xl border border-slate-100">
+        <Text className="text-3xl font-bold text-slate-900 mb-2">Welcome</Text>
+        <Text className="text-slate-500 mb-8">Sign in to access your SuperApp modules</Text>\n        
+        <TouchableOpacity 
+          onPress={() => login()}
+          className="w-full bg-indigo-600 py-4 rounded-2xl items-center shadow-lg active:bg-indigo-700"
+        >
+          <Text className="text-white font-semibold text-lg">Entrar no App</Text>
+        </TouchableOpacity>
+      </View>
+    </View>
+  );
+}`,
+
+  globalCss: `@tailwind base;\n@tailwind components;\n@tailwind utilities;`,
+
+  moduleLoader: `import { ScriptManager } from "@callstack/repack/client";
+
+export async function loadModule(config) {
+  await ScriptManager.shared.addScript({
+    id: config.id,
+    url: config.url
+  });
+
+  const container = global[config.scope];
+  if (!container) throw new Error("Module " + config.scope + " not found");
+
+  await container.init(__webpack_share_scopes__.default);
+  const factory = await container.get(config.module);
+  return factory();
+}`,
+
+  dashboard: `import { View, Text, ScrollView, TouchableOpacity } from "react-native";
+import { Link } from "expo-router";
+import { useAuth } from "@/providers/auth";
+
+const MOCK_MODULES = [
+  { id: 'mod1', name: 'Sales Dashboard', icon: '📊' },
+  { id: 'mod2', name: 'Inventory Manager', icon: '📦' },
+];
+
+export default function Dashboard() {
+  const { logout } = useAuth();
+
+  return (
+    <ScrollView className="flex-1 bg-slate-50 p-6 pt-16">
+      <View className="flex-row justify-between items-center mb-8">
+        <View>
+           <Text className="text-sm text-slate-500">Welcome back,</Text>
+           <Text className="text-2xl font-bold text-slate-900">Explorer</Text>
+        </View>
+        <TouchableOpacity onPress={logout} className="p-2">
+           <Text className="text-red-500 font-medium">Logout</Text>
+        </TouchableOpacity>
+      </View>
+
+      <Text className="text-lg font-semibold text-slate-800 mb-4">Your Modules</Text>
+      
+      {MOCK_MODULES.map(m => (
+        <Link key={m.id} href={\`/(protected)/module/${m.id}\`} asChild>
+          <TouchableOpacity className="bg-white p-6 rounded-2xl mb-4 shadow-sm border border-slate-100 flex-row items-center">
+            <Text className="text-3xl mr-4">{m.icon}</Text>
+            <View className="flex-1">
+              <Text className="text-lg font-bold text-slate-900">{m.name}</Text>
+              <Text className="text-slate-500">Tap to open module</Text>
+            </View>
+          </TouchableOpacity>
+        </Link>
+      ))}
+    </ScrollView>
+  );
+}`,
+
+  modulePage: `import { useLocalSearchParams } from "expo-router";
+import { View, Text, ActivityIndicator } from "react-native";
+import { useEffect, useState } from "react";
+import { loadModule } from "@/lib/moduleLoader";
+
+export default function ModulePage() {
+  const { id } = useLocalSearchParams();
+  const [Module, setModule] = useState(null);
+  const [error, setError] = useState(null);
+
+  useEffect(() => {\n    // In real app, fetch config from registry by id\n    setError("Module dynamic loading requires a running CDN and Build setup.");\n  }, [id]);
+
+  if (error) return (
+    <View className="flex-1 items-center justify-center p-10 bg-white">
+       <Text className="text-red-500 text-center font-medium mb-4">{error}</Text>
+       <Text className="text-slate-400 text-center text-sm">Follow the README to setup your module registry.</Text>
+    </View>
+  );
+
+  return (
+    <View className="flex-1 bg-white items-center justify-center">
+       <ActivityIndicator size="large" color="#4f46e5" />
+       <Text className="mt-4 text-slate-500">Loading federated module...</Text>
+    </View>
+  );
+}`
+};

package/src/cli/utils/config.js

@@ -0,0 +1,11 @@
+const fs = require('fs-extra');
+const path = require('path');
+
+const getWorkspaceConfig = () => {
+  let configPath = path.join(process.cwd(), 'esad.config.json');
+  if (!fs.existsSync(configPath)) configPath = path.join(process.cwd(), '../esad.config.json');
+  if (!fs.existsSync(configPath)) return null;
+  return { path: configPath, data: fs.readJsonSync(configPath) };
+};
+
+module.exports = { getWorkspaceConfig };

package/src/cli/utils/process.js

@@ -0,0 +1,20 @@
+const { spawn } = require('cross-spawn');
+
+/**
+ * Helper to spawn commands synchronously
+ * @param {string} cmd 
+ * @param {string[]} args 
+ * @param {string} cwd 
+ * @returns {Promise<void>}
+ */
+const runProcess = (cmd, args, cwd = process.cwd()) => {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, { stdio: 'inherit', cwd, shell: true });
+    child.on('close', code => {
+      if (code !== 0) reject(new Error(`Command ${cmd} ${args.join(' ')} failed`));
+      else resolve();
+    });
+  });
+};
+
+module.exports = { runProcess };