@idealyst/cli 1.0.84 → 1.0.86

package/dist/generators/utils.js

@@ -426,7 +426,7 @@ async function mergePackageJsonDependencies(templatePath, projectPath, data) {
             '@trpc/server': '^11.5.1',
             'react-native-edge-to-edge': '^1.6.2',
             'react-native-gesture-handler': '^2.27.1',
-            'react-native-nitro-modules': '^0.26.3',
+            'react-native-nitro-modules': '^0.30.0',
             'react-native-reanimated': '^3.18.0',
             'react-native-safe-area-context': '^5.5.1',
             'react-native-screens': '^4.11.1',

package/dist/templates/shared/src/components/HelloWorld.tsx

@@ -55,7 +55,7 @@ export const HelloWorld = ({
     <Screen style={{ flex: 1, padding: 20 }}>
       <View style={{ maxWidth: 600, alignSelf: "center" }}>
         <Text
-          size="xlarge"
+          size="xl"
           weight="bold"
           style={{
             marginBottom: 16,
@@ -83,7 +83,7 @@ export const HelloWorld = ({
           <View style={{ alignItems: "center" }}>
             <Text style={{ fontSize: 32, marginBottom: 16 }}>🚀</Text>
             <Text
-              size="xlarge"
+              size="xl"
               weight="bold"
               style={{ marginBottom: 8, textAlign: "center" }}
             >

package/dist/templates/shared/src/navigation/AppRouter.tsx

@@ -6,7 +6,7 @@ import { HelloWorld } from '../components/HelloWorld';
 const HomeScreen = () => (
   <Screen>
     <View spacing="lg">
-      <Text size="xlarge" weight="bold">Home</Text>
+      <Text size="xl" weight="bold">Home</Text>
       <Text size="md">Welcome to your {{projectName}} app!</Text>
       <View spacing="md" style={{ marginTop: 24 }}>
         <Text size="sm">
@@ -26,7 +26,7 @@ const HomeScreen = () => (
 const ProfileScreen = () => (
   <Screen>
     <View spacing="lg">
-      <Text size="xlarge" weight="bold">Profile</Text>
+      <Text size="xl" weight="bold">Profile</Text>
       <Text size="md">User profile and account settings</Text>
       <View spacing="md" style={{ marginTop: 24 }}>
         <Text size="sm">
@@ -40,7 +40,7 @@ const ProfileScreen = () => (
 const SettingsScreen = () => (
   <Screen>
     <View spacing="lg">
-      <Text size="xlarge" weight="bold">Settings</Text>
+      <Text size="xl" weight="bold">Settings</Text>
       <Text size="md">App configuration and preferences</Text>
       <View spacing="md" style={{ marginTop: 24 }}>
         <Text size="sm">

package/dist/templates/web/README.md

@@ -122,22 +122,6 @@ The app uses the Idealyst Framework for consistent UI and navigation that works
 
 Edit `src/App.tsx` to start building your application.
 
-### Styling
-
-The app uses Unistyles for cross-platform styling. You can create styles that work on both web and mobile:
-
-```tsx
-import { createStyleSheet } from 'react-native-unistyles';
-
-const styles = createStyleSheet({
-  container: {
-    flex: 1,
-    justifyContent: 'center',
-    alignItems: 'center'
-  }
-});
-```
-
 ### Learn More
 
 - [Idealyst Framework Documentation](https://github.com/your-username/idealyst-framework)

package/dist/templates/web/package.json

@@ -30,7 +30,7 @@
     "react-dom": "^19.1.0",
     "react-native": "^0.80.1",
     "react-native-edge-to-edge": "^1.6.2",
-    "react-native-nitro-modules": "0.28.0",
+    "react-native-nitro-modules": "0.30.0",
     "react-native-unistyles": "^3.0.10",
     "react-native-web": "^0.20.0",
     "react-router": "^7.6.3",

package/dist/templates/web/vite.config.ts

@@ -1,28 +1,43 @@
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import babel from 'vite-plugin-babel'
-import path from 'path'
+import react from "@vitejs/plugin-react";
+import path from "path";
+import { defineConfig } from "vite";
+import babel from "vite-plugin-babel";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
     babel({
-      filter: (id) => id.includes("node_modules/@idealyst/") || id.includes("/packages/"),
+      filter: (id) =>
+        id.includes("node_modules/@idealyst/") ||
+        (id.includes("/packages/") &&
+          !id.includes("/packages/web/") &&
+          /\.(tsx?|jsx?)$/.test(id)),
       babelConfig: {
         presets: [
-          ['@babel/preset-typescript', {
-            isTSX: true,
-            allExtensions: true,
-          }]
+          ["@babel/preset-react", { runtime: "automatic" }],
+          [
+            "@babel/preset-typescript",
+            {
+              isTSX: true,
+              allExtensions: true,
+            },
+          ],
         ],
         plugins: [
-          ['react-native-unistyles/plugin', {
-            root: 'src',
-            autoProcessPaths: ['@idealyst/components', '@idealyst/navigation', '@idealyst/theme'],
-          }],
-          ['@idealyst/components/plugin/web', { root: 'src' }]
-        ]
-      }
+          [
+            "react-native-unistyles/plugin",
+            {
+              root: "src",
+              autoProcessPaths: [
+                "@idealyst/components",
+                "@idealyst/navigation",
+                "@idealyst/theme",
+              ],
+            },
+          ],
+          ["@idealyst/components/plugin/web", { root: "src" }],
+        ],
+      },
     }),
     // Then process everything else with React plugin
     react(),
@@ -30,48 +45,54 @@ export default defineConfig({
   resolve: {
     alias: {
       // Use absolute path to resolve react-native-web properly
-      'react-native': path.resolve(__dirname, 'node_modules/react-native-web'),
-      '@react-native/normalize-colors': path.resolve(__dirname, 'node_modules/@react-native/normalize-colors'),
+      "react-native": path.resolve(__dirname, "node_modules/react-native-web"),
+      "@react-native/normalize-colors": path.resolve(
+        __dirname,
+        "../../node_modules/@react-native/normalize-colors"
+      ),
     },
     // Platform-specific file resolution
-    extensions: ['.web.tsx', '.web.ts', '.tsx', '.ts', '.js', '.jsx'],
+    extensions: [".web.tsx", ".web.ts", ".tsx", ".ts", ".js", ".jsx"],
     // Ensure proper resolution of package exports
-    conditions: ['browser', 'import', 'module', 'default'],
+    conditions: ["browser", "import", "module", "default"],
     // Ensure workspace dependencies resolve properly
-    preserveSymlinks: false
+    preserveSymlinks: false,
   },
   define: {
-    global: 'globalThis',
+    global: "globalThis",
     __DEV__: JSON.stringify(true),
   },
   optimizeDeps: {
     include: [
-      'react-native-web',
-      '@react-native/normalize-colors',
-      'react-native-unistyles',
-      'react-native-unistyles/web',
-      '@mdi/react',
-      '@mdi/js',
+      "react-native-web",
+      "react-native-unistyles",
+      "react-native-unistyles/web",
+      "@mdi/react",
+      "@mdi/js",
     ],
     exclude: [
-      'react-native-edge-to-edge',
-      'react-native-nitro-modules',
-      '@idealyst/components',
-      '@idealyst/navigation', 
-      '@idealyst/theme',
-      '@{{workspaceScope}}/shared',
+      "react-native-edge-to-edge",
+      "react-native-nitro-modules",
+      "@idealyst/components",
+      "@idealyst/navigation",
+      "@idealyst/theme",
+      "@test/shared",
     ],
     esbuildOptions: {
       loader: {
-        '.tsx': 'tsx',
-        '.ts': 'ts',
-        '.jsx': 'jsx',
-        '.js': 'jsx' // Important: treat .js files as JSX for React Native compatibility
-      }
-    }
+        ".tsx": "tsx",
+        ".ts": "ts",
+        ".jsx": "jsx",
+        ".js": "jsx", // Important: treat .js files as JSX for React Native compatibility
+      },
+      alias: {
+        "react-native": path.resolve(__dirname, "node_modules/react-native-web"),
+        "@react-native/normalize-colors": path.resolve(__dirname, "../../node_modules/@react-native/normalize-colors"),
+      },
+    },
   },
   server: {
-    host: '0.0.0.0',
+    host: "0.0.0.0",
     port: 5173,
   },
-}) 
+});

package/dist/templates/workspace/.devcontainer/Dockerfile

@@ -1,6 +1,6 @@
 FROM node:20-bullseye
 
-# Install additional tools
+# Install additional tools including gosu for proper user switching
 RUN apt-get update && apt-get install -y \
     git \
     postgresql-client \
@@ -18,6 +18,9 @@ RUN git config --global init.defaultBranch main
 # Create workspace directory
 RUN mkdir -p /workspace
 WORKDIR /workspace
+RUN chown -R node:node /workspace
 
-# Keep container running
-CMD ["sleep", "infinity"]
+# Note: We don't switch to node user here anymore - entrypoint.sh will do it
+# This allows the entrypoint to fix permissions as root first
+
+USER node

package/dist/templates/workspace/.devcontainer/devcontainer.json

@@ -106,6 +106,7 @@
       }
     }
   },
+  "remoteUser": "node",
 
   // Post-create command to set up the development environment
   "postCreateCommand": "bash .devcontainer/setup.sh"

package/dist/templates/workspace/.devcontainer/setup.sh

@@ -2,10 +2,6 @@
 
 echo "🚀 Setting up Idealyst development environment..."
 
-# Install dependencies
-echo "📦 Installing dependencies..."
-yarn install
-
 # Create environment file if it doesn't exist
 if [ ! -f ".env" ]; then
     echo "📝 Creating .env file..."
@@ -42,24 +38,6 @@ until pg_isready -h postgres -p 5432 -U postgres; do
     sleep 1
 done
 
-echo "✅ Database is ready!"
-
-# Run database migrations if they exist
-if [ -d "packages" ]; then
-    echo "🗄️ Setting up database..."
-    
-    # Check if any package has prisma
-    for package_dir in packages/*/; do
-        if [ -f "${package_dir}prisma/schema.prisma" ]; then
-            echo "Running Prisma setup for $(basename "$package_dir")..."
-            cd "$package_dir"
-            npx prisma generate
-            npx prisma db push
-            cd /workspace
-        fi
-    done
-fi
-
 echo "Add Figma MCP to Claude Code"
 claude mcp add -t sse figma-mcp http://figma-mcp:3333/sse
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/cli",
-  "version": "1.0.84",
+  "version": "1.0.86",
   "description": "CLI tool for generating Idealyst Framework projects",
   "readme": "README.md",
   "main": "dist/index.js",

package/templates/web/vite.config.ts

@@ -1,7 +1,7 @@
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import babel from 'vite-plugin-babel'
-import path from 'path'
+import react from "@vitejs/plugin-react";
+import path from "path";
+import { defineConfig } from "vite";
+import babel from "vite-plugin-babel";
 
 // https://vitejs.dev/config/
 export default defineConfig({
@@ -9,21 +9,35 @@ export default defineConfig({
     babel({
       filter: (id) =>
         id.includes("node_modules/@idealyst/") ||
-        (id.includes("/packages/") && /\.(tsx?|jsx?)$/.test(id)),      babelConfig: {
+        (id.includes("/packages/") &&
+          !id.includes("/packages/web/") &&
+          /\.(tsx?|jsx?)$/.test(id)),
+      babelConfig: {
         presets: [
-          ['@babel/preset-typescript', {
-            isTSX: true,
-            allExtensions: true,
-          }]
+          ["@babel/preset-react", { runtime: "automatic" }],
+          [
+            "@babel/preset-typescript",
+            {
+              isTSX: true,
+              allExtensions: true,
+            },
+          ],
         ],
         plugins: [
-          ['react-native-unistyles/plugin', {
-            root: 'src',
-            autoProcessPaths: ['@idealyst/components', '@idealyst/navigation', '@idealyst/theme'],
-          }],
-          ['@idealyst/components/plugin/web', { root: 'src' }]
-        ]
-      }
+          [
+            "react-native-unistyles/plugin",
+            {
+              root: "src",
+              autoProcessPaths: [
+                "@idealyst/components",
+                "@idealyst/navigation",
+                "@idealyst/theme",
+              ],
+            },
+          ],
+          ["@idealyst/components/plugin/web", { root: "src" }],
+        ],
+      },
     }),
     // Then process everything else with React plugin
     react(),
@@ -31,48 +45,54 @@ export default defineConfig({
   resolve: {
     alias: {
       // Use absolute path to resolve react-native-web properly
-      'react-native': path.resolve(__dirname, 'node_modules/react-native-web'),
-      '@react-native/normalize-colors': path.resolve(__dirname, 'node_modules/@react-native/normalize-colors'),
+      "react-native": path.resolve(__dirname, "node_modules/react-native-web"),
+      "@react-native/normalize-colors": path.resolve(
+        __dirname,
+        "../../node_modules/@react-native/normalize-colors"
+      ),
     },
     // Platform-specific file resolution
-    extensions: ['.web.tsx', '.web.ts', '.tsx', '.ts', '.js', '.jsx'],
+    extensions: [".web.tsx", ".web.ts", ".tsx", ".ts", ".js", ".jsx"],
     // Ensure proper resolution of package exports
-    conditions: ['browser', 'import', 'module', 'default'],
+    conditions: ["browser", "import", "module", "default"],
     // Ensure workspace dependencies resolve properly
-    preserveSymlinks: false
+    preserveSymlinks: false,
   },
   define: {
-    global: 'globalThis',
+    global: "globalThis",
     __DEV__: JSON.stringify(true),
   },
   optimizeDeps: {
     include: [
-      'react-native-web',
-      '@react-native/normalize-colors',
-      'react-native-unistyles',
-      'react-native-unistyles/web',
-      '@mdi/react',
-      '@mdi/js',
+      "react-native-web",
+      "react-native-unistyles",
+      "react-native-unistyles/web",
+      "@mdi/react",
+      "@mdi/js",
     ],
     exclude: [
-      'react-native-edge-to-edge',
-      'react-native-nitro-modules',
-      '@idealyst/components',
-      '@idealyst/navigation', 
-      '@idealyst/theme',
-      '@{{workspaceScope}}/shared',
+      "react-native-edge-to-edge",
+      "react-native-nitro-modules",
+      "@idealyst/components",
+      "@idealyst/navigation",
+      "@idealyst/theme",
+      "@test/shared",
     ],
     esbuildOptions: {
       loader: {
-        '.tsx': 'tsx',
-        '.ts': 'ts',
-        '.jsx': 'jsx',
-        '.js': 'jsx' // Important: treat .js files as JSX for React Native compatibility
-      }
-    }
+        ".tsx": "tsx",
+        ".ts": "ts",
+        ".jsx": "jsx",
+        ".js": "jsx", // Important: treat .js files as JSX for React Native compatibility
+      },
+      alias: {
+        "react-native": path.resolve(__dirname, "node_modules/react-native-web"),
+        "@react-native/normalize-colors": path.resolve(__dirname, "../../node_modules/@react-native/normalize-colors"),
+      },
+    },
   },
   server: {
-    host: '0.0.0.0',
+    host: "0.0.0.0",
     port: 5173,
   },
-}) 
+});

package/templates/workspace/.devcontainer/Dockerfile

@@ -1,6 +1,6 @@
 FROM node:20-bullseye
 
-# Install additional tools
+# Install additional tools including gosu for proper user switching
 RUN apt-get update && apt-get install -y \
     git \
     postgresql-client \
@@ -18,6 +18,9 @@ RUN git config --global init.defaultBranch main
 # Create workspace directory
 RUN mkdir -p /workspace
 WORKDIR /workspace
+RUN chown -R node:node /workspace
 
-# Keep container running
-CMD ["sleep", "infinity"]
+# Note: We don't switch to node user here anymore - entrypoint.sh will do it
+# This allows the entrypoint to fix permissions as root first
+
+USER node

package/templates/workspace/.devcontainer/setup.sh

@@ -2,10 +2,6 @@
 
 echo "🚀 Setting up Idealyst development environment..."
 
-# Install dependencies
-echo "📦 Installing dependencies..."
-yarn install
-
 # Create environment file if it doesn't exist
 if [ ! -f ".env" ]; then
     echo "📝 Creating .env file..."
@@ -42,24 +38,6 @@ until pg_isready -h postgres -p 5432 -U postgres; do
     sleep 1
 done
 
-echo "✅ Database is ready!"
-
-# Run database migrations if they exist
-if [ -d "packages" ]; then
-    echo "🗄️ Setting up database..."
-    
-    # Check if any package has prisma
-    for package_dir in packages/*/; do
-        if [ -f "${package_dir}prisma/schema.prisma" ]; then
-            echo "Running Prisma setup for $(basename "$package_dir")..."
-            cd "$package_dir"
-            npx prisma generate
-            npx prisma db push
-            cd /workspace
-        fi
-    done
-fi
-
 echo "Add Figma MCP to Claude Code"
 claude mcp add -t sse figma-mcp http://figma-mcp:3333/sse
 

package/dist/docs/LLM-CLI-QUICK-REFERENCE.md

@@ -1,123 +0,0 @@
-# Idealyst Framework CLI - Quick LLM Command Reference
-
-⚠️ **LLM CRITICAL**: Always provide ALL arguments to prevent interactive prompts that hang automation!
-
-## 🚨 Commands That Will Hang LLMs
-```bash
-# ❌ These will hang waiting for user input:
-idealyst init                              # Missing workspace name
-idealyst create my-app                     # Missing --type
-idealyst create my-app --type native       # Missing --app-name
-idealyst create my-app --type web          # Missing tRPC choice
-idealyst create my-app --type native --app-name "App"  # Missing tRPC choice
-```
-
-## ✅ LLM-Safe Command Templates
-```bash
-# Always use these exact patterns:
-idealyst init <workspace-name>
-idealyst create <name> --type database
-idealyst create <name> --type api  
-idealyst create <name> --type shared
-idealyst create <name> --type native --app-name "Display Name" --with-trpc
-idealyst create <name> --type native --app-name "Display Name" --no-trpc
-idealyst create <name> --type web --with-trpc
-idealyst create <name> --type web --no-trpc
-```
-
-## Essential Commands
-
-### Initialize Workspace (Required First)
-```bash
-# ✅ Always provide workspace name
-idealyst init <workspace-name>
-cd <workspace-name>
-
-# ❌ Never run without name (will prompt)
-# idealyst init
-```
-
-### Create Projects (Run from workspace directory)
-```bash
-# Database layer (Prisma + Zod) - No prompts
-idealyst create <name> --type database
-
-# API server (tRPC + Express) - No prompts  
-idealyst create <name> --type api
-
-# React Native mobile app - REQUIRES app-name and trpc preference
-idealyst create <name> --type native --app-name "Display Name" --with-trpc
-idealyst create <name> --type native --app-name "Display Name" --no-trpc
-
-# React web app (Vite) - REQUIRES trpc preference
-idealyst create <name> --type web --with-trpc
-idealyst create <name> --type web --no-trpc
-
-# Shared TypeScript library - No prompts
-idealyst create <name> --type shared
-```
-
-## Project Types & Purposes
-
-| Type | Purpose | Key Technologies | Exports |
-|------|---------|------------------|---------|
-| `database` | Data layer | Prisma, Zod, TypeScript | `{ db, schemas, PrismaClient, types }` |
-| `api` | Backend server | tRPC, Express, Zod | tRPC router, middleware |
-| `native` | Mobile app | React Native, TypeScript | Mobile application |
-| `web` | Web app | React, Vite, TypeScript | Web application |
-| `shared` | Utilities | TypeScript, Rollup | Reusable functions/types |
-
-## Architecture Patterns
-
-### Full-Stack App (Recommended)
-```bash
-# ✅ LLM-Safe: All arguments provided
-idealyst init my-app && cd my-app
-idealyst create database --type database
-idealyst create api --type api
-idealyst create mobile --type native --app-name "Mobile App" --with-trpc
-idealyst create web --type web --with-trpc
-```
-
-### Database Integration
-```typescript
-// In API server
-import { db } from '@workspace/database';
-const users = await db.user.findMany();
-
-// In clients (with tRPC)
-const { data } = await api.users.getAll.useQuery();
-```
-
-## Key Rules for LLMs
-1. **Always provide workspace name** - `idealyst init my-project` (never just `idealyst init`)
-2. **Always provide project name AND --type** - `idealyst create api --type api` 
-3. **For native: Always provide --app-name AND tRPC choice** - `--app-name "App Name" --with-trpc`
-4. **For web: Always provide tRPC choice** - `--with-trpc` or `--no-trpc`
-5. **Use --skip-install** - For faster testing/iteration
-6. **Use descriptive names** - `user-database`, `product-api`, not `db`, `api`
-
-## Common Patterns
-```bash
-# E-commerce (full arguments)
-idealyst init ecommerce-platform && cd ecommerce-platform
-idealyst create product-database --type database
-idealyst create api --type api
-idealyst create customer-mobile --type native --app-name "Customer App" --with-trpc
-idealyst create admin-web --type web --with-trpc
-
-# SaaS (full arguments) 
-idealyst init saas-app && cd saas-app
-idealyst create user-database --type database
-idealyst create auth-api --type api
-idealyst create main-api --type api
-idealyst create dashboard --type web --with-trpc
-idealyst create mobile --type native --app-name "SaaS Mobile" --with-trpc
-
-# Content platform (full arguments)
-idealyst init content-platform && cd content-platform
-idealyst create content-database --type database
-idealyst create cms-api --type api
-idealyst create public-web --type web --no-trpc
-idealyst create admin-web --type web --with-trpc
-```

package/dist/docs/LLM-CLI-REFERENCE.md

@@ -1,514 +0,0 @@
-# Idealyst Framework CLI - LLM Reference Guide
-
-This is a comprehensive reference for LLMs to understand and use the Idealyst Framework CLI to create full-stack TypeScript projects.
-
-## Overview
-
-The Idealyst Framework CLI is a powerful tool for generating TypeScript monorepo projects with React Native, React Web, API servers, database layers, and shared libraries. All projects are type-safe and follow modern development practices.
-
-## CLI Installation & Usage
-
-```bash
-# Install globally
-npm install -g @idealyst/cli
-
-# Or use via npx
-npx @idealyst/cli [command] [options]
-```
-
-⚠️ **IMPORTANT FOR LLMs**: Always provide ALL required arguments to avoid interactive prompts that can hang automated processes.
-
-## 🚨 Critical LLM Requirements
-
-### Commands That Will Hang LLMs
-```bash
-# ❌ These commands will hang waiting for user input:
-idealyst init                                    # Missing workspace name  
-idealyst create my-app                           # Missing --type
-idealyst create my-app --type native             # Missing --app-name
-idealyst create my-app --type web                # Missing tRPC preference
-idealyst create my-app --type native --app-name "App"  # Missing tRPC preference
-```
-
-### LLM-Safe Command Templates
-```bash
-# ✅ Always use these exact patterns:
-idealyst init <workspace-name>                   # Always provide name
-idealyst create <name> --type database           # Database: no extra args needed
-idealyst create <name> --type api                # API: no extra args needed
-idealyst create <name> --type shared             # Shared: no extra args needed
-idealyst create <name> --type native --app-name "Name" --with-trpc    # Native: both required
-idealyst create <name> --type native --app-name "Name" --no-trpc      # Native: both required  
-idealyst create <name> --type web --with-trpc    # Web: tRPC choice required
-idealyst create <name> --type web --no-trpc      # Web: tRPC choice required
-```
-
-## Core Commands
-
-### 1. Initialize Workspace
-**Purpose**: Create a new monorepo workspace that can contain multiple related projects.
-
-```bash
-# Create a new workspace (ALWAYS provide project name)
-idealyst init <workspace-name> [options]
-
-# Options:
-# -d, --directory <dir>    Output directory (default: .)
-# --skip-install          Skip installing dependencies
-
-# ✅ LLM-Safe Examples:
-idealyst init my-workspace
-idealyst init ecommerce-platform --directory ./projects
-idealyst init my-app --skip-install
-```
-
-**⚠️ LLM Warning**: Never run `idealyst init` without a project name - it will prompt interactively and hang.
-
-**What it creates:**
-- Yarn workspace configuration
-- TypeScript configuration
-- Build scripts and tooling
-- Package management setup
-- Version management scripts
-- Base Idealyst packages (theme, components, navigation)
-
-### 2. Create Projects
-**Purpose**: Create individual projects within a workspace.
-
-```bash
-# General syntax (ALWAYS provide project name AND type)
-idealyst create <project-name> --type <type> [options]
-
-# Options:
-# -t, --type <type>           Project type: native, web, shared, api, or database
-# -d, --directory <dir>       Output directory (default: .)
-# -a, --app-name <name>       Display name for native apps (REQUIRED for native)
-# --with-trpc                 Include tRPC boilerplate (for web/native)
-# --no-trpc                   Explicitly disable tRPC (for web/native)
-# --skip-install              Skip installing dependencies
-
-# ✅ LLM-Safe Examples:
-idealyst create my-api --type api
-idealyst create user-database --type database
-idealyst create mobile-app --type native --app-name "Mobile App"
-idealyst create web-app --type web --with-trpc
-idealyst create utils --type shared
-```
-
-**⚠️ LLM Critical Rules**:
-1. **Always provide `<project-name>`** - CLI will prompt if missing
-2. **Always provide `--type <type>`** - CLI will prompt if missing  
-3. **For native projects**: Always provide `--app-name "Display Name"` - CLI will prompt if missing
-4. **For web/native projects**: Always specify `--with-trpc` or `--no-trpc` - CLI will prompt if missing
-
-## Project Types
-
-### 1. Native (React Native)
-**Purpose**: Cross-platform mobile applications
-
-```bash
-# ✅ LLM-Safe Command (always include --app-name)
-idealyst create my-mobile-app --type native --app-name "My Mobile App"
-
-# With tRPC integration
-idealyst create mobile-app --type native --app-name "Mobile App" --with-trpc
-
-# Without tRPC integration (explicit)
-idealyst create mobile-app --type native --app-name "Mobile App" --no-trpc
-```
-
-**⚠️ LLM Required**: `--app-name` is REQUIRED for native projects to avoid interactive prompts.
-
-**Includes:**
-- React Native setup with TypeScript
-- Idealyst UI components
-- Navigation system
-- Platform-specific configurations (iOS/Android)
-- Jest testing setup
-- Optional tRPC integration
-
-**Key files:**
-- `src/App.tsx` - Main application component
-- `android/` - Android-specific code
-- `ios/` - iOS-specific code
-- `jest.config.js` - Testing configuration
-
-### 2. Web (React Web)
-**Purpose**: Web applications using React
-
-```bash
-# ✅ LLM-Safe Commands (always specify tRPC preference)
-idealyst create my-web-app --type web --with-trpc
-idealyst create my-web-app --type web --no-trpc
-
-# With additional options
-idealyst create web-dashboard --type web --with-trpc --skip-install
-```
-
-**⚠️ LLM Required**: Always specify `--with-trpc` or `--no-trpc` to avoid interactive prompts.
-
-**Includes:**
-- React with TypeScript and Vite
-- Idealyst UI components (web-compatible)
-- Unistyles for styling
-- Jest testing setup
-- Optional tRPC integration
-
-**Key files:**
-- `src/App.tsx` - Main application component
-- `src/main.tsx` - Entry point
-- `vite.config.ts` - Vite configuration
-- `index.html` - HTML template
-
-### 3. API Server
-**Purpose**: Backend API servers with tRPC
-
-```bash
-# ✅ LLM-Safe Command
-idealyst create my-api --type api
-
-# With additional options
-idealyst create user-api --type api --skip-install
-```
-
-**Includes:**
-- tRPC for type-safe APIs
-- Express.js server
-- Zod schema validation
-- TypeScript configuration
-- Middleware system (auth, CORS, etc.)
-- Controller pattern
-- Jest testing setup
-
-**Key files:**
-- `src/server.ts` - Express server setup
-- `src/index.ts` - Main exports
-- `src/context.ts` - tRPC context
-- `src/router/index.ts` - Route definitions
-- `src/controllers/` - API controllers
-- `src/middleware/` - Custom middleware
-
-**Note**: API projects no longer include database functionality (see Database type below).
-
-### 4. Database
-**Purpose**: Shared database layer with Prisma
-
-```bash
-# ✅ LLM-Safe Command
-idealyst create my-database --type database
-
-# With additional options
-idealyst create user-database --type database --skip-install
-```
-
-**Includes:**
-- Prisma ORM setup
-- TypeScript configuration
-- Zod schemas for validation
-- Database client singleton
-- Migration scripts
-- Seed scripts
-- Jest testing setup
-
-**Key files:**
-- `src/index.ts` - Main exports (db, schemas, types)
-- `src/client.ts` - Prisma client singleton
-- `src/schemas.ts` - Zod validation schemas
-- `prisma/schema.prisma` - Database schema
-- `prisma/seed.ts` - Database seeding
-
-**Exports for consumption:**
-```typescript
-// Import in other packages
-import { db, schemas, PrismaClient } from '@workspace/my-database';
-import type { User, Post } from '@workspace/my-database';
-
-// Use the database
-const users = await db.user.findMany();
-const validData = schemas.createUser.parse(input);
-```
-
-### 5. Shared Library
-**Purpose**: Reusable code shared across projects
-
-```bash
-# ✅ LLM-Safe Command
-idealyst create my-shared-lib --type shared
-
-# With additional options
-idealyst create utils --type shared --skip-install
-```
-
-**Includes:**
-- TypeScript library setup
-- Rollup build configuration
-- Jest testing setup
-- NPM package structure
-
-**Key files:**
-- `src/index.ts` - Main exports
-- `rollup.config.js` - Build configuration
-
-## Project Architecture Patterns
-
-### Monorepo Structure
-```
-my-workspace/
-├── package.json              # Workspace root
-├── packages/
-│   ├── mobile-app/           # React Native app
-│   ├── web-app/              # React web app
-│   ├── api-server/           # tRPC API server
-│   ├── user-database/        # Database layer
-│   └── shared-utils/         # Shared library
-└── node_modules/
-```
-
-### Database + API Pattern
-**Recommended approach for full-stack applications:**
-
-1. **Create database package first:**
-```bash
-idealyst create user-database --type database
-```
-
-2. **Create API server:**
-```bash
-idealyst create api-server --type api
-```
-
-3. **Connect them in API:**
-```typescript
-// In api-server/src/controllers/UserController.ts
-import { db } from '@workspace/user-database';
-import type { User } from '@workspace/user-database';
-
-export class UserController {
-  async getUsers() {
-    return await db.user.findMany();
-  }
-}
-```
-
-### Client + API Pattern
-**For frontend applications with backend:**
-
-1. **Create API first:**
-```bash
-idealyst create api-server --type api
-idealyst create user-database --type database
-```
-
-2. **Create client apps:**
-```bash
-idealyst create mobile-app --type native --with-trpc
-idealyst create web-app --type web --with-trpc
-```
-
-3. **Connect with tRPC:**
-```typescript
-// In client app
-import { createTRPCProxyClient } from '@trpc/client';
-import type { AppRouter } from '@workspace/api-server';
-
-const api = createTRPCProxyClient<AppRouter>({
-  links: [httpBatchLink({ url: 'http://localhost:3000/trpc' })]
-});
-```
-
-## Development Workflow
-
-### 1. Initial Setup
-```bash
-# Create workspace (provide name to avoid prompts)
-idealyst init my-project
-
-cd my-project
-
-# Create database layer (no additional args needed)
-idealyst create database --type database
-
-# Create API server (no additional args needed)
-idealyst create api --type api
-
-# Create client apps (specify tRPC and app-name to avoid prompts)
-idealyst create mobile --type native --app-name "Mobile App" --with-trpc
-idealyst create web --type web --with-trpc
-```
-
-### 2. Database Development
-```bash
-cd packages/database
-
-# Edit prisma/schema.prisma
-# Add your models
-
-# Generate client
-yarn db:generate
-
-# Push to database
-yarn db:push
-
-# Build for consumption
-yarn build
-```
-
-### 3. API Development
-```bash
-cd packages/api
-
-# Import database
-# Edit src/controllers/ files
-# Add your endpoints
-
-# Start development server
-yarn dev
-```
-
-### 4. Client Development
-```bash
-# Mobile
-cd packages/mobile
-yarn android  # or yarn ios
-
-# Web
-cd packages/web
-yarn dev
-```
-
-## Best Practices for LLMs
-
-### 1. Always Start with Workspace
-Never create individual projects without a workspace:
-```bash
-# ❌ Wrong - will fail
-idealyst create my-app --type native --app-name "My App"
-
-# ✅ Correct - always init workspace first
-idealyst init my-workspace
-cd my-workspace
-idealyst create my-app --type native --app-name "My App" --with-trpc
-```
-
-### 2. Always Provide ALL Required Arguments
-```bash
-# ❌ Wrong - will hang on prompts
-idealyst init
-idealyst create --type native
-idealyst create mobile-app
-
-# ✅ Correct - full arguments prevent prompts
-idealyst init my-project
-idealyst create mobile-app --type native --app-name "Mobile App" --with-trpc
-idealyst create web-app --type web --no-trpc
-```
-
-### 3. Use --skip-install for Speed
-```bash
-# ✅ For faster iteration/testing
-idealyst init my-project --skip-install
-idealyst create api --type api --skip-install
-```
-
-### 2. Database-First for Full-Stack
-For applications needing persistence:
-```bash
-# 1. Create workspace (provide name)
-idealyst init e-commerce-app
-
-# 2. Create database first (no prompts)
-idealyst create database --type database
-
-# 3. Create API (no prompts)
-idealyst create api --type api
-
-# 4. Create clients (specify all args)
-idealyst create mobile --type native --app-name "E-Commerce Mobile" --with-trpc
-idealyst create admin --type web --with-trpc
-```
-
-### 3. Use Descriptive Names (No Prompts)
-```bash
-# ✅ Good names with full arguments
-idealyst create user-database --type database
-idealyst create product-api --type api
-idealyst create customer-mobile --type native --app-name "Customer Mobile" --with-trpc
-
-# ❌ Avoid generic names and missing arguments
-idealyst create db --type database
-idealyst create api --type api
-idealyst create app  # Missing --type, will prompt
-```
-
-### 4. Leverage Type Safety
-The framework provides end-to-end type safety:
-- Database types from Prisma
-- API types from tRPC
-- Component types from TypeScript React
-
-### 5. Follow the Separation of Concerns
-- **Database packages**: Only data models and database access
-- **API packages**: Only business logic and endpoints
-- **Client packages**: Only UI and user interaction
-- **Shared packages**: Only reusable utilities
-
-## Example Project Setups
-
-### E-commerce Platform
-```bash
-idealyst init ecommerce-platform
-cd ecommerce-platform
-
-# Core data layer
-idealyst create product-database --type database
-
-# Backend services
-idealyst create product-api --type api
-idealyst create payment-api --type api
-
-# Client applications
-idealyst create customer-mobile --type native --with-trpc
-idealyst create admin-web --type web --with-trpc
-
-# Shared utilities
-idealyst create shared-utils --type shared
-```
-
-### SaaS Application
-```bash
-idealyst init saas-app
-cd saas-app
-
-# Data layer
-idealyst create user-database --type database
-
-# Backend
-idealyst create auth-api --type api
-idealyst create main-api --type api
-
-# Clients
-idealyst create mobile-app --type native --with-trpc
-idealyst create web-dashboard --type web --with-trpc
-
-# Shared
-idealyst create common-types --type shared
-```
-
-## Error Handling
-
-### Common Issues:
-1. **"Individual projects can only be created within a workspace"**
-   - Solution: Run `idealyst init` first
-
-2. **"Invalid project name"**
-   - Solution: Use lowercase, no spaces, valid npm package names
-
-3. **"Invalid project type"**
-   - Solution: Use one of: native, web, shared, api, database
-
-### Debugging:
-- Use `--skip-install` for faster iteration
-- Check generated package.json files
-- Verify workspace structure
-
-This reference should enable LLMs to effectively use the Idealyst Framework CLI to create comprehensive, type-safe, full-stack TypeScript applications.