feat: package manager repo init steps

.gitignore

@@ -1,3 +1,4 @@
+node_modules/
 .git/
 .planning/
 **/.DS_Store

README.md

@@ -6,6 +6,10 @@
 
 A powerful CLI tool to quickly scaffold **React Native** and **Expo** TypeScript projects with best practices.
 
+<p align="center">
+  <img src="docs/img/terminal-view.png" alt="VoltRN CLI terminal view" width="100%" />
+</p>
+
 ## Features
 
 - ✅ React Native CLI or Expo support
@@ -284,9 +288,7 @@ Expected endpoints:
 
 ### Documentation
 
-Generated projects with auth flow include:
-- `AUTH_FLOW.md` - Complete authentication documentation
-- `IMPLEMENTATION_SUMMARY.md` - Implementation details
+Generated projects with auth flow include a `README.md` with complete authentication documentation.
 
 ## Project Structure
 

cli/setup/auth.js

@@ -8,7 +8,7 @@ const {
   writeBabelConfig,
 } = require('../utils/babel-config');
 
-function setupAuthFlow(projectPath, isExpo, useExpoRouter = false, screenConfig = null) {
+async function setupAuthFlow(projectPath, isExpo, useExpoRouter = false, screenConfig = null, pm) {
   // Default screen config if none provided
   const config = screenConfig || {
     hasAuth: true,
@@ -21,19 +21,13 @@ function setupAuthFlow(projectPath, isExpo, useExpoRouter = false, screenConfig
 
   // Install auth packages
   // For Expo Router, we don't need @react-navigation/bottom-tabs since we use expo-router tabs
-  if (isExpo) {
-    if (useExpoRouter) {
-      executeCommand(
-        'npm install @forward-software/react-auth axios jwt-check-expiry --legacy-peer-deps'
-      );
-    } else {
-      executeCommand(
-        'npm install @forward-software/react-auth @react-navigation/bottom-tabs axios jwt-check-expiry --legacy-peer-deps'
-      );
-    }
+  if (useExpoRouter) {
+    await executeCommand(
+      pm.add('@forward-software/react-auth axios jwt-check-expiry')
+    );
   } else {
-    executeCommand(
-      'npm install @forward-software/react-auth @react-navigation/bottom-tabs axios jwt-check-expiry'
+    await executeCommand(
+      pm.add('@forward-software/react-auth @react-navigation/bottom-tabs axios jwt-check-expiry')
     );
   }
 

cli/setup/bootsplash.js

@@ -12,13 +12,13 @@ const { log } = require('../utils/logger');
  * @param {boolean} useExpoRouter - Whether the project uses Expo Router
  * @param {boolean} useAuthFlow - Whether auth flow is enabled
  */
-function setupBootsplash(projectPath, isExpo, useExpoRouter, useAuthFlow) {
+async function setupBootsplash(projectPath, isExpo, useExpoRouter, useAuthFlow, pm) {
   log.info('Installing react-native-bootsplash and react-native-toolbox...');
 
   // Install packages
-  executeCommand('npm install react-native-bootsplash', { cwd: projectPath });
-  executeCommand(
-    'npm install --save-dev @forward-software/react-native-toolbox',
+  await executeCommand(pm.add('react-native-bootsplash'), { cwd: projectPath });
+  await executeCommand(
+    pm.addDev('@forward-software/react-native-toolbox'),
     { cwd: projectPath },
   );
 
@@ -46,8 +46,8 @@ function setupBootsplash(projectPath, isExpo, useExpoRouter, useAuthFlow) {
 
   // Run initial splash and icon generation (RN CLI only. Expo does it during prebuild)
   if (!isExpo) {
-    runSplashGeneration(projectPath);
-    runIconGeneration(projectPath);
+    await runSplashGeneration(projectPath);
+    await runIconGeneration(projectPath);
   }
 
   // Wire up BootSplash.hide() in the app entry point
@@ -120,9 +120,9 @@ function configureExpoPlugin(projectPath) {
 /**
  * Run the initial splash screen generation for RN CLI projects
  */
-function runSplashGeneration(projectPath) {
+async function runSplashGeneration(projectPath) {
   try {
-    executeCommand(
+    await executeCommand(
       'npx react-native-bootsplash generate assets/splashscreen.svg --platforms=android,ios --background=1A1A2E --logo-width=128 --assets-output=assets/bootsplash',
       { cwd: projectPath },
     );
@@ -137,9 +137,9 @@ function runSplashGeneration(projectPath) {
 /**
  * Run the initial app icon generation for RN CLI projects
  */
-function runIconGeneration(projectPath) {
+async function runIconGeneration(projectPath) {
   try {
-    executeCommand(
+    await executeCommand(
       'npx @forward-software/react-native-toolbox icons assets/icon.svg',
       { cwd: projectPath },
     );

cli/setup/framework.js

@@ -1,36 +1,30 @@
 const { executeCommand } = require('../utils/commands');
 const { log } = require('../utils/logger');
 
-function createProject(projectName, isExpo) {
-  log.step(
-    `Creating ${isExpo ? 'Expo' : 'React Native'} TypeScript project...`
-  );
+async function createProject(projectName, isExpo) {
   if (isExpo) {
-    executeCommand(
-      `npx create-expo-app@latest ${projectName} --template blank-typescript`
+    await executeCommand(
+      `npx create-expo-app@latest ${projectName} --template blank-typescript`,
     );
   } else {
-    executeCommand(
-      `npx @react-native-community/cli@latest init ${projectName}`
+    await executeCommand(
+      `npx @react-native-community/cli@latest init ${projectName}`,
     );
   }
 }
 
-function installIOSDependencies(projectPath) {
+async function installIOSDependencies(projectPath) {
   const path = require('path');
   const fs = require('fs');
 
-  log.step('Installing iOS dependencies...');
   try {
     const iosPath = path.join(projectPath, 'ios');
     if (fs.existsSync(iosPath)) {
-      log.info('Running pod install (this may take a few minutes)...');
-      executeCommand('cd ios && pod install && cd ..', { cwd: projectPath });
-      log.success('iOS dependencies installed');
+      await executeCommand('cd ios && pod install && cd ..', { cwd: projectPath });
     }
   } catch (error) {
     log.warning(
-      'Failed to run pod install. Please run "cd ios && pod install" manually before running on iOS.'
+      'Failed to run pod install. Please run "cd ios && pod install" manually before running on iOS.',
     );
   }
 }

cli/setup/git.js

@@ -0,0 +1,22 @@
+const { execSync } = require('child_process');
+const { log } = require('../utils/logger');
+
+function initGitRepository(projectPath) {
+  try {
+    execSync('git init', { cwd: projectPath, stdio: 'pipe' });
+    execSync('git add .', { cwd: projectPath, stdio: 'pipe' });
+    execSync('git commit -m "Initial commit via voltrn-cli"', {
+      cwd: projectPath,
+      stdio: 'pipe',
+    });
+    log.success('Git repository initialized with initial commit');
+  } catch (error) {
+    log.warning(
+      'Could not initialize git repository. Make sure git is installed.'
+    );
+  }
+}
+
+module.exports = {
+  initGitRepository,
+};

cli/setup/i18n.js

@@ -8,23 +8,19 @@ const {
   writeBabelConfig,
 } = require('../utils/babel-config');
 
-function setupI18n(projectPath, isExpo) {
+async function setupI18n(projectPath, isExpo, pm) {
   log.info('Installing i18next with TypeScript support...');
+  await executeCommand(
+    pm.add('i18next react-i18next react-native-mmkv react-native-nitro-modules')
+  );
   if (isExpo) {
-    // Use legacy-peer-deps to handle Expo's React version conflicts
-    executeCommand(
-      'npm install i18next react-i18next react-native-mmkv react-native-nitro-modules --legacy-peer-deps'
-    );
-    executeCommand('npx expo install react-native-localize');
-    executeCommand(
-      'npm install --save-dev babel-plugin-module-resolver babel-preset-expo @expo/config-plugins --legacy-peer-deps'
+    await executeCommand('npx expo install react-native-localize');
+    await executeCommand(
+      pm.addDev('babel-plugin-module-resolver babel-preset-expo @expo/config-plugins')
     );
   } else {
-    executeCommand(
-      'npm install i18next react-i18next react-native-mmkv react-native-nitro-modules'
-    );
-    executeCommand('npm install react-native-localize');
-    executeCommand('npm install --save-dev babel-plugin-module-resolver');
+    await executeCommand(pm.add('react-native-localize'));
+    await executeCommand(pm.addDev('babel-plugin-module-resolver'));
   }
 
   // Ensure src directory exists (for both Expo and React Native CLI)
@@ -246,11 +242,6 @@ export const switchLocaleTo = (locale: string) => {
     tsconfig.compilerOptions = {};
   }
 
-  // Set baseUrl for better path resolution
-  if (!tsconfig.compilerOptions.baseUrl) {
-    tsconfig.compilerOptions.baseUrl = '.';
-  }
-
   if (!tsconfig.compilerOptions.paths) {
     tsconfig.compilerOptions.paths = {};
   }

cli/setup/license.js

@@ -10,7 +10,9 @@ const { log } = require('../utils/logger');
  *
  * @param {string} projectPath - Path to the generated project
  */
-function setupLicense(projectPath) {
+function setupLicense(projectPath, spinner) {
+  spinner?.message('Adding MPL-2.0 license...');
+
   // Copy LICENSE file from CLI root to generated project
   const sourceLicense = path.join(__dirname, '..', '..', 'LICENSE');
   const destLicense = path.join(projectPath, 'LICENSE');
@@ -29,8 +31,6 @@ function setupLicense(projectPath) {
     pkg.license = 'MPL-2.0';
     fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
   }
-
-  log.success('MPL-2.0 license added');
 }
 
 module.exports = { setupLicense };

cli/setup/navigation.js

@@ -16,7 +16,7 @@ const {
   createDynamicScreens,
 } = require('./dynamic-screens');
 
-function setupReactNavigation(projectPath, isExpo, useI18n, screenConfig = null, useTheme = false) {
+async function setupReactNavigation(projectPath, isExpo, useI18n, screenConfig = null, useTheme = false, pm) {
   log.info('Installing React Navigation...');
 
   const config = screenConfig || {
@@ -29,19 +29,16 @@ function setupReactNavigation(projectPath, isExpo, useI18n, screenConfig = null,
   const pattern = config.navigationPattern || NAVIGATION_PATTERNS.STACK;
 
   // Base React Navigation packages
+  await executeCommand(
+    pm.add('@react-navigation/native @react-navigation/native-stack')
+  );
   if (isExpo) {
-    executeCommand(
-      'npm install @react-navigation/native @react-navigation/native-stack --legacy-peer-deps'
-    );
-    executeCommand(
+    await executeCommand(
       'npx expo install react-native-screens react-native-safe-area-context'
     );
   } else {
-    executeCommand(
-      'npm install @react-navigation/native @react-navigation/native-stack'
-    );
-    executeCommand(
-      'npm install react-native-screens react-native-safe-area-context'
+    await executeCommand(
+      pm.add('react-native-screens react-native-safe-area-context')
     );
   }
 
@@ -50,29 +47,21 @@ function setupReactNavigation(projectPath, isExpo, useI18n, screenConfig = null,
     pattern === NAVIGATION_PATTERNS.TABS ||
     pattern === NAVIGATION_PATTERNS.TABS_DRAWER
   ) {
-    if (isExpo) {
-      executeCommand(
-        'npm install @react-navigation/bottom-tabs --legacy-peer-deps'
-      );
-    } else {
-      executeCommand('npm install @react-navigation/bottom-tabs');
-    }
+    await executeCommand(pm.add('@react-navigation/bottom-tabs'));
   }
 
   if (
     pattern === NAVIGATION_PATTERNS.DRAWER ||
     pattern === NAVIGATION_PATTERNS.TABS_DRAWER
   ) {
+    await executeCommand(pm.add('@react-navigation/drawer'));
     if (isExpo) {
-      executeCommand(
-        'npm install @react-navigation/drawer --legacy-peer-deps'
-      );
-      executeCommand(
+      await executeCommand(
         'npx expo install react-native-gesture-handler react-native-reanimated react-native-worklets'
       );
     } else {
-      executeCommand(
-        'npm install @react-navigation/drawer react-native-gesture-handler react-native-reanimated react-native-worklets'
+      await executeCommand(
+        pm.add('react-native-gesture-handler react-native-reanimated react-native-worklets')
       );
     }
 
@@ -135,9 +124,9 @@ function setupReactNavigation(projectPath, isExpo, useI18n, screenConfig = null,
   }
 }
 
-function setupExpoRouter(projectPath, useI18n, useAuthFlow = false, screenConfig = null, useTheme = false) {
+async function setupExpoRouter(projectPath, useI18n, useAuthFlow = false, screenConfig = null, useTheme = false, pm) {
   log.info('Installing Expo Router...');
-  executeCommand(
+  await executeCommand(
     'npx expo install expo-router react-native-safe-area-context react-native-screens expo-linking expo-constants expo-status-bar react-dom'
   );
 
@@ -167,7 +156,7 @@ function setupExpoRouter(projectPath, useI18n, useAuthFlow = false, screenConfig
     pattern === NAVIGATION_PATTERNS.DRAWER ||
     pattern === NAVIGATION_PATTERNS.TABS_DRAWER
   ) {
-    executeCommand(
+    await executeCommand(
       'npx expo install @react-navigation/drawer react-native-gesture-handler react-native-reanimated react-native-worklets'
     );