@idealyst/cli 1.0.29 → 1.0.31

package/dist/index.js

@@ -2,8 +2,8 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
 import path from 'path';
-import { fileURLToPath } from 'url';
 import fs from 'fs-extra';
+import { fileURLToPath } from 'url';
 import { spawn } from 'child_process';
 import ora from 'ora';
 import validatePackageName from 'validate-npm-package-name';
@@ -119,12 +119,23 @@ async function installDependencies(projectPath, skipInstall = false) {
 }
 function runCommand(command, args, options) {
     return new Promise((resolve, reject) => {
+        const timeoutMs = options.timeout || 300000; // 5 minutes default timeout
         const process = spawn(command, args, {
             cwd: options.cwd,
-            stdio: 'inherit',
+            stdio: ['pipe', 'inherit', 'inherit'], // Pipe stdin to prevent hanging on prompts
             shell: true
         });
+        // Set up timeout
+        const timeoutId = setTimeout(() => {
+            process.kill('SIGTERM');
+            reject(new Error(`Command timed out after ${timeoutMs / 1000} seconds`));
+        }, timeoutMs);
+        // Close stdin immediately to prevent hanging on interactive prompts
+        if (process.stdin) {
+            process.stdin.end();
+        }
         process.on('close', (code) => {
+            clearTimeout(timeoutId);
             if (code === 0) {
                 resolve();
             }
@@ -133,6 +144,7 @@ function runCommand(command, args, options) {
             }
         });
         process.on('error', (error) => {
+            clearTimeout(timeoutId);
             reject(error);
         });
     });
@@ -210,9 +222,15 @@ async function resolveProjectPath(projectName, directory) {
 async function initializeReactNativeProject(projectName, directory, displayName, skipInstall) {
     const spinner = ora('Initializing React Native project...').start();
     try {
-        // Use the correct React Native CLI command format with specific version and yarn
+        // Use create-react-native-app for a more reliable setup
         const cliCommand = 'npx';
-        const args = ['@react-native-community/cli@latest', 'init', projectName, '--version', '0.80.1', '--pm', 'yarn', '--skip-git-init'];
+        const args = [
+            'react-native@latest',
+            'init',
+            projectName,
+            '--pm', 'yarn',
+            '--skip-git-init'
+        ];
         // Add title if displayName is provided
         if (displayName) {
             args.push('--title', displayName);
@@ -221,19 +239,31 @@ async function initializeReactNativeProject(projectName, directory, displayName,
         if (skipInstall) {
             args.push('--skip-install');
         }
-        // Run React Native initialization in the target directory
-        await runCommand(cliCommand, args, { cwd: directory });
+        spinner.text = 'Initializing React Native project (this may take a few minutes)...';
+        // Run React Native initialization with timeout
+        await runCommand(cliCommand, args, {
+            cwd: directory,
+            timeout: 600000 // 10 minutes timeout for React Native init
+        });
         spinner.succeed('React Native project initialized successfully');
     }
     catch (error) {
         spinner.fail('Failed to initialize React Native project');
-        console.log(chalk.yellow('Make sure you have the React Native CLI and yarn available:'));
-        console.log(chalk.white('  npx @react-native-community/cli@latest init ProjectName --version 0.80.1 --pm yarn --skip-git-init'));
-        console.log(chalk.yellow('If you encounter issues, try:'));
-        console.log(chalk.white('  npm install -g @react-native-community/cli'));
-        console.log(chalk.white('  npm install -g yarn'));
-        console.log(chalk.white('  # or'));
-        console.log(chalk.white('  yarn global add @react-native-community/cli'));
+        if (error instanceof Error && error.message.includes('timed out')) {
+            console.log(chalk.red('❌ React Native initialization timed out'));
+            console.log(chalk.yellow('This can happen due to:'));
+            console.log(chalk.white('  • Slow internet connection'));
+            console.log(chalk.white('  • Network issues downloading dependencies'));
+            console.log(chalk.white('  • React Native CLI hanging on prompts'));
+        }
+        console.log(chalk.yellow('\n💡 Alternative approaches:'));
+        console.log(chalk.white('1. Try manually creating the project:'));
+        console.log(chalk.white(`   npx react-native@latest init ${projectName} --pm yarn --skip-git-init`));
+        console.log(chalk.white('\n2. Use Expo (faster alternative):'));
+        console.log(chalk.white(`   npx create-expo-app@latest ${projectName} --template blank-typescript`));
+        console.log(chalk.white('\n3. Ensure prerequisites:'));
+        console.log(chalk.white('   npm install -g react-native-cli'));
+        console.log(chalk.white('   npm install -g @react-native-community/cli'));
         throw error;
     }
 }
@@ -506,43 +536,70 @@ async function generateNativeProject(options) {
     const templatePath = path.join(__dirname$4, '..', 'templates', 'native');
     const templateData = getTemplateData(name, `React Native app built with Idealyst Framework`, displayName, workspaceScope || undefined);
     try {
-        // Step 1: Update workspace configuration FIRST (before React Native CLI)
+        // Step 1: Update workspace configuration FIRST
         await updateWorkspacePackageJson(workspacePath, directory);
-        // Step 2: Initialize React Native project using CLI with --skip-install
-        // Note: For React Native CLI, we need to run it in the parent directory and specify the project name
-        const projectDir = path.dirname(projectPath);
-        const projectName = path.basename(projectPath);
-        await initializeReactNativeProject(projectName, projectDir, displayName, true);
-        // Step 3: Overlay Idealyst-specific files
-        await overlayIdealystFiles(templatePath, projectPath, templateData);
+        // Step 2: Try React Native CLI initialization, with fallback to template-only
+        const useRnCli = process.env.IDEALYST_USE_RN_CLI !== 'false';
+        if (useRnCli) {
+            try {
+                console.log(chalk.blue('🚀 Attempting React Native CLI initialization...'));
+                console.log(chalk.gray('   (This creates proper Android/iOS native directories)'));
+                // Initialize React Native project using CLI with --skip-install
+                const projectDir = path.dirname(projectPath);
+                const projectName = path.basename(projectPath);
+                await initializeReactNativeProject(projectName, projectDir, displayName, true);
+                // Step 3: Overlay Idealyst-specific files
+                await overlayIdealystFiles(templatePath, projectPath, templateData);
+                console.log(chalk.green('✅ React Native project created with native platform support'));
+            }
+            catch (rnError) {
+                console.log(chalk.yellow('⚠️  React Native CLI failed, falling back to template-only approach...'));
+                await createNativeProjectFromTemplate(templatePath, projectPath, templateData);
+                console.log(chalk.yellow('📝 Template-only project created. You may need to run "npx react-native init" later for native platforms.'));
+            }
+        }
+        else {
+            console.log(chalk.blue('��️  Creating project from template only (IDEALYST_USE_RN_CLI=false)'));
+            await createNativeProjectFromTemplate(templatePath, projectPath, templateData);
+        }
         // Step 4: Handle tRPC setup
         if (withTrpc) {
             await copyTrpcFiles(templatePath, projectPath, templateData);
             await copyTrpcAppComponent(templatePath, projectPath, templateData);
         }
-        // Step 5: Configure Android vector icons
-        await configureAndroidVectorIcons(projectPath);
-        // Step 6: Remove tRPC dependencies if not requested (after merge but before install)
+        // Step 5: Configure Android vector icons (only if we have Android directory)
+        const hasAndroid = await fs.pathExists(path.join(projectPath, 'android'));
+        if (hasAndroid) {
+            await configureAndroidVectorIcons(projectPath);
+        }
+        // Step 6: Remove tRPC dependencies if not requested
         if (!withTrpc) {
             await removeTrpcDependencies(projectPath);
         }
-        // Step 7: Install dependencies (including Idealyst packages) after workspace config is updated
+        // Step 7: Install dependencies
         await installDependencies(projectPath, skipInstall);
         console.log(chalk.green('✅ React Native project created successfully!'));
         console.log(chalk.blue('📋 Project includes:'));
-        console.log(chalk.white('  • React Native with proper Android/iOS setup'));
-        console.log(chalk.white('  • Idealyst Components'));
-        console.log(chalk.white('  • Idealyst Navigation'));
-        console.log(chalk.white('  • Idealyst Theme'));
-        console.log(chalk.white('  • React Native Vector Icons (configured)'));
-        console.log(chalk.white('  • TypeScript configuration'));
-        console.log(chalk.white('  • Metro configuration'));
-        console.log(chalk.white('  • Babel configuration'));
-        console.log(chalk.white('  • Native platform directories (android/, ios/)'));
+        console.log(chalk.white('  • React Native with TypeScript'));
+        console.log(chalk.white('  • Idealyst Components & Navigation'));
+        console.log(chalk.white('  • Idealyst Theme & Styling'));
+        console.log(chalk.white('  • Jest testing configuration'));
+        console.log(chalk.white('  • Metro & Babel configuration'));
+        if (hasAndroid) {
+            console.log(chalk.white('  • Android native platform setup'));
+            console.log(chalk.white('  • React Native Vector Icons (configured)'));
+        }
+        const hasIos = await fs.pathExists(path.join(projectPath, 'ios'));
+        if (hasIos) {
+            console.log(chalk.white('  • iOS native platform setup'));
+        }
+        if (!hasAndroid && !hasIos) {
+            console.log(chalk.yellow('  ⚠️  No native platforms detected'));
+            console.log(chalk.yellow('     Run "npx react-native init" in project directory for native support'));
+        }
         if (withTrpc) {
             console.log(chalk.white('  • tRPC client setup and utilities'));
             console.log(chalk.white('  • React Query integration'));
-            console.log(chalk.white('  • Pre-configured tRPC provider'));
         }
     }
     catch (error) {
@@ -551,6 +608,10 @@ async function generateNativeProject(options) {
         throw error;
     }
 }
+// Helper function to create project from template only (fallback when RN CLI fails)
+async function createNativeProjectFromTemplate(templatePath, projectPath, templateData) {
+    await copyTemplate(templatePath, projectPath, templateData);
+}
 
 const __filename$3 = fileURLToPath(import.meta.url);
 const __dirname$3 = path.dirname(__filename$3);

package/dist/types/generators/utils.d.ts

@@ -8,6 +8,7 @@ export declare function processTemplateFile(filePath: string, data: TemplateData
 export declare function installDependencies(projectPath: string, skipInstall?: boolean): Promise<void>;
 export declare function runCommand(command: string, args: string[], options: {
     cwd: string;
+    timeout?: number;
 }): Promise<void>;
 export declare function getTemplateData(projectName: string, description?: string, appName?: string, workspaceScope?: string): TemplateData;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/cli",
-  "version": "1.0.29",
+  "version": "1.0.31",
   "description": "CLI tool for generating Idealyst Framework projects",
   "type": "module",
   "main": "dist/index.js",
@@ -19,10 +19,11 @@
     "access": "public"
   },
   "scripts": {
-    "build": "rollup -c",
-    "dev": "rollup -c -w",
-    "prepublishOnly": "yarn build",
-    "publish:npm": "npm publish"
+    "build": "tsc",
+    "test": "jest",
+    "test:integration": "jest __tests__/integration.test.ts",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
   },
   "dependencies": {
     "chalk": "^5.0.0",
@@ -35,13 +36,16 @@
   "devDependencies": {
     "@types/fs-extra": "^11.0.0",
     "@types/inquirer": "^9.0.0",
+    "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
     "@types/validate-npm-package-name": "^4.0.0",
+    "jest": "^29.7.0",
     "rollup": "^3.20.0",
     "rollup-plugin-commonjs": "^10.1.0",
     "rollup-plugin-json": "^4.0.0",
     "rollup-plugin-node-resolve": "^5.2.0",
     "rollup-plugin-typescript2": "^0.34.0",
+    "ts-jest": "^29.1.0",
     "typescript": "^5.0.0"
   },
   "files": [

package/templates/shared/rollup.config.js

@@ -0,0 +1,43 @@
+const typescript = require('rollup-plugin-typescript2');
+
+module.exports = {
+  input: 'src/index.ts',
+  output: [
+    {
+      file: 'dist/index.js',
+      format: 'cjs',
+      exports: 'named',
+      sourcemap: true,
+    },
+    {
+      file: 'dist/index.esm.js',
+      format: 'esm',
+      exports: 'named',
+      sourcemap: true,
+    },
+  ],
+  plugins: [
+    typescript({
+      typescript: require('typescript'),
+      tsconfig: './tsconfig.json',
+      exclude: ['**/*.test.ts', '**/*.test.tsx', '**/*.native.ts', '**/*.native.tsx'],
+      declaration: true,
+      declarationDir: 'dist',
+      rootDir: 'src',
+      clean: true,
+    }),
+  ],
+  external: [
+    'react',
+    'react-dom',
+    'react-native',
+    'react-native-unistyles',
+    '@react-native/normalize-colors',
+    'react-native-edge-to-edge',
+    'react-native-nitro-modules',
+    '@react-native-vector-icons/common',
+    '@react-native-vector-icons/material-design-icons',
+    '@mdi/js',
+    '@mdi/react',
+  ],
+}; 

package/templates/workspace/.devcontainer/post-create.sh

@@ -6,6 +6,9 @@ echo "🚀 Setting up Idealyst development environment..."
 # Set proper permissions
 sudo chown -R devuser:devuser /app
 
+# Make scripts executable
+chmod +x /app/scripts/*.sh
+
 # Install dependencies if not already installed
 if [ ! -d "/app/node_modules" ]; then
     echo "📦 Installing dependencies..."

package/templates/workspace/.dockerignore

@@ -87,7 +87,7 @@ LICENSE
 
 # Package manager files
 package-lock.json
-yarn.lock
+# yarn.lock - DO NOT IGNORE: Required for immutable installs
 pnpm-lock.yaml
 
 # Development scripts

package/templates/workspace/DOCKER.md

@@ -295,7 +295,20 @@ All services include health checks:
    docker-compose build --no-cache
    ```
 
-4. **Permission Issues**
+4. **Yarn Lockfile Issues** 
+   If you see "The lockfile would have been created by this install, which is explicitly forbidden":
+   ```bash
+   # Create lockfile first
+   yarn install
+   
+   # Then build Docker
+   docker-compose build
+   
+   # Alternative: Use development mode (handles missing lockfile)
+   docker-compose up dev
+   ```
+
+5. **Permission Issues**
    ```bash
    # Fix file permissions
    sudo chown -R $USER:$USER .

package/templates/workspace/Dockerfile

@@ -11,9 +11,17 @@ RUN corepack enable
 
 # Dependencies stage - install all dependencies
 FROM base AS deps
-COPY package.json yarn.lock* .yarnrc.yml ./
+COPY package.json yarn.lock .yarnrc.yml ./
 COPY .yarn .yarn
-RUN yarn install --immutable
+
+# Create packages directory structure and copy package.json files
+RUN mkdir -p packages/api packages/app packages/components packages/web
+COPY packages/api/package.json ./packages/api/
+COPY packages/app/package.json ./packages/app/
+COPY packages/components/package.json ./packages/components/
+COPY packages/web/package.json ./packages/web/
+
+RUN yarn install
 
 # Build stage - build all packages
 FROM base AS builder
@@ -70,9 +78,16 @@ RUN apk add --no-cache \
 RUN npm install -g @types/node typescript ts-node nodemon
 
 # Copy package files
-COPY package.json yarn.lock* .yarnrc.yml ./
+COPY package.json yarn.lock .yarnrc.yml ./
 COPY .yarn .yarn
 
+# Create packages directory structure and copy package.json files
+RUN mkdir -p packages/api packages/app packages/components packages/web
+COPY packages/api/package.json ./packages/api/
+COPY packages/app/package.json ./packages/app/
+COPY packages/components/package.json ./packages/components/
+COPY packages/web/package.json ./packages/web/
+
 # Install dependencies including dev dependencies
 RUN yarn install
 

package/templates/workspace/README.md

@@ -130,6 +130,10 @@ This workspace includes comprehensive Docker support for development, staging, a
 ### Quick Start with Docker
 
 ```bash
+# Use the Docker build helper (recommended)
+./scripts/docker-build.sh dev
+
+# Or manually:
 # Development environment
 cp .env.example .env
 ./scripts/docker/deploy.sh development
@@ -140,6 +144,8 @@ cp .env.production .env
 ./scripts/docker/deploy.sh production
 ```
 
+**Docker Build Helper**: The `./scripts/docker-build.sh` script automatically handles common issues like missing yarn.lock files and environment configuration.
+
 ### VS Code Dev Container
 
 Open this workspace in VS Code and select "Reopen in Container" for a fully configured development environment with:

package/templates/workspace/scripts/docker-build.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+
+# Docker build helper script for Idealyst workspace
+# Handles common issues like missing yarn.lock files
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}🐳 Idealyst Docker Build Helper${NC}"
+echo ""
+
+# Check if yarn.lock exists
+if [ ! -f "yarn.lock" ]; then
+    echo -e "${YELLOW}⚠️  yarn.lock not found${NC}"
+    echo "This can cause Docker build failures with 'immutable' installs."
+    echo ""
+    read -p "Would you like to generate yarn.lock now? (y/N): " -n 1 -r
+    echo ""
+    
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        echo -e "${BLUE}📦 Installing dependencies to generate yarn.lock...${NC}"
+        yarn install
+        echo -e "${GREEN}✅ yarn.lock generated${NC}"
+    else
+        echo -e "${YELLOW}⚠️  Continuing without yarn.lock (may cause build issues)${NC}"
+    fi
+    echo ""
+fi
+
+# Check if .env exists
+if [ ! -f ".env" ]; then
+    echo -e "${YELLOW}⚠️  .env file not found${NC}"
+    if [ -f ".env.example" ]; then
+        read -p "Would you like to copy .env.example to .env? (y/N): " -n 1 -r
+        echo ""
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            cp .env.example .env
+            echo -e "${GREEN}✅ .env file created from .env.example${NC}"
+            echo -e "${YELLOW}📝 Please review and update .env with your settings${NC}"
+        fi
+    else
+        echo -e "${YELLOW}📝 Please create a .env file with your configuration${NC}"
+    fi
+    echo ""
+fi
+
+# Determine what to build
+if [ $# -eq 0 ]; then
+    echo "What would you like to do?"
+    echo "1) Build and start development environment"
+    echo "2) Build and start production services"
+    echo "3) Build specific service"
+    echo "4) Just build (no start)"
+    echo ""
+    read -p "Choice (1-4): " -n 1 -r
+    echo ""
+    
+    case $REPLY in
+        1)
+            echo -e "${BLUE}🚀 Building and starting development environment...${NC}"
+            docker-compose build dev
+            docker-compose up -d postgres redis
+            docker-compose up dev
+            ;;
+        2)
+            echo -e "${BLUE}🚀 Building and starting production services...${NC}"
+            docker-compose build
+            docker-compose up -d
+            ;;
+        3)
+            echo "Available services: api, web, dev, postgres, redis"
+            read -p "Service name: " service
+            echo -e "${BLUE}🚀 Building ${service}...${NC}"
+            docker-compose build $service
+            ;;
+        4)
+            echo -e "${BLUE}🏗️  Building all services...${NC}"
+            docker-compose build
+            ;;
+        *)
+            echo -e "${RED}❌ Invalid choice${NC}"
+            exit 1
+            ;;
+    esac
+else
+    # Handle command line arguments
+    case "$1" in
+        "dev")
+            echo -e "${BLUE}🚀 Building and starting development environment...${NC}"
+            docker-compose build dev
+            docker-compose up -d postgres redis
+            docker-compose up dev
+            ;;
+        "prod"|"production")
+            echo -e "${BLUE}🚀 Building and starting production services...${NC}"
+            docker-compose build
+            docker-compose up -d
+            ;;
+        "build")
+            if [ -n "$2" ]; then
+                echo -e "${BLUE}🏗️  Building ${2}...${NC}"
+                docker-compose build $2
+            else
+                echo -e "${BLUE}🏗️  Building all services...${NC}"
+                docker-compose build
+            fi
+            ;;
+        "help"|"-h"|"--help")
+            echo "Usage: $0 [command] [service]"
+            echo ""
+            echo "Commands:"
+            echo "  dev          Build and start development environment"
+            echo "  prod         Build and start production services"
+            echo "  build [svc]  Build all services or specific service"
+            echo "  help         Show this help"
+            echo ""
+            echo "Services: api, web, dev, postgres, redis"
+            ;;
+        *)
+            echo -e "${RED}❌ Unknown command: $1${NC}"
+            echo "Use '$0 help' for usage information"
+            exit 1
+            ;;
+    esac
+fi
+
+echo ""
+echo -e "${GREEN}🎉 Done!${NC}"
+
+# Show helpful information
+if docker-compose ps | grep -q "Up"; then
+    echo ""
+    echo -e "${BLUE}📋 Running services:${NC}"
+    docker-compose ps
+    echo ""
+    echo -e "${BLUE}🔗 Access your application:${NC}"
+    echo "• Web: http://localhost:3000"
+    echo "• API: http://localhost:3001"
+    echo "• Vite Dev: http://localhost:5173"
+    echo ""
+    echo -e "${BLUE}💡 Useful commands:${NC}"
+    echo "• View logs: docker-compose logs -f"
+    echo "• Stop services: docker-compose down"
+    echo "• Access dev container: docker-compose exec dev bash"
+fi