@totaland/create-starter-kit 2.0.1 → 2.0.3

package/README.md

@@ -1,10 +1,10 @@
 # @totaland/create-starter-kit
 
-Scaffolding tool for creating new starter-kit projects with a choice between backend and frontend templates.
+Scaffolding tool for creating new starter-kit projects with a choice between backend, frontend, or fullstack templates.
 
 ## Features
 
-- ✨ Interactive template selection (backend or frontend)
+- ✨ Interactive template selection (backend, frontend, or fullstack)
 - 🎯 CLI argument support for automation
 - 📦 Clean, production-ready templates
 - 🚀 Quick project initialization
@@ -20,6 +20,7 @@ pnpm create @totaland/starter-kit my-new-project
 You'll be prompted to select a template:
 - **Backend** - Express.js + TypeScript + Drizzle ORM + Scalar API docs
 - **Frontend** - React + Vite + TypeScript + Tailwind CSS v4 + shadcn/ui + TanStack Query
+- **Fullstack** - Both Backend and Frontend in one project
 
 ### With Template Argument
 
@@ -31,6 +32,9 @@ pnpm create @totaland/starter-kit my-backend backend
 
 # Create frontend project
 pnpm create @totaland/starter-kit my-frontend frontend
+
+# Create fullstack project (both backend and frontend)
+pnpm create @totaland/starter-kit my-app fullstack
 ```
 
 ### Alternative Package Managers
@@ -107,10 +111,29 @@ pnpm dev
 pnpm dlx shadcn@latest add button card dialog
 ```
 
+### Fullstack Template
+
+Creates both backend and frontend in separate subdirectories.
+
+**After Creation:**
+```bash
+cd my-app
+
+# Run backend
+cd backend
+pnpm install
+pnpm dev
+
+# Run frontend (in another terminal)
+cd frontend
+pnpm install
+pnpm dev
+```
+
 ## What It Does
 
 1. ✅ Creates a new directory with your project name
-2. ✅ Copies the selected template (backend or frontend)
+2. ✅ Copies the selected template (backend, frontend, or both for fullstack)
 3. ✅ Updates the `package.json` name field to match your project name
 4. ✅ Provides next steps for installation and running the project
 
@@ -139,6 +162,7 @@ To test this locally before publishing:
    # Or specify template directly
    pnpm create @totaland/starter-kit test-backend backend
    pnpm create @totaland/starter-kit test-frontend frontend
+   pnpm create @totaland/starter-kit test-fullstack fullstack
    ```
 
 ## Publishing

package/bin/index.js

@@ -21,7 +21,7 @@ const templateArg = process.argv[3]; // Optional template argument
 if (!projectName) {
     console.error('Error: Please provide a project name');
     console.log('Usage: pnpm create @totaland/starter-kit <project-name> [template]');
-    console.log('Templates: backend, frontend');
+    console.log('Templates: backend, frontend, fullstack');
     process.exit(1);
 }
 
@@ -47,8 +47,30 @@ const TEMPLATES = {
         description: 'React + Vite with TypeScript, Tailwind CSS v4, shadcn/ui, and TanStack Query',
         dir: 'frontend',
     },
+    fullstack: {
+        name: 'Fullstack',
+        description: 'Both Backend and Frontend templates combined',
+        dirs: ['backend', 'frontend'],
+    },
 };
 
+// Directories and files to exclude when copying
+const EXCLUDE = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.turbo',
+    '.next',
+    '.nuxt',
+    '.output',
+    '.cache',
+    'coverage',
+    '.env',
+    '.env.local',
+    '.DS_Store',
+]);
+
 // Function to recursively copy directory
 function copyDir(src, dest) {
     mkdirSync(dest, { recursive: true });
@@ -56,6 +78,11 @@ function copyDir(src, dest) {
     const entries = readdirSync(src, { withFileTypes: true });
 
     for (const entry of entries) {
+        // Skip excluded files and directories
+        if (EXCLUDE.has(entry.name)) {
+            continue;
+        }
+
         const srcPath = join(src, entry.name);
         const destPath = join(dest, entry.name);
 
@@ -75,10 +102,11 @@ async function promptTemplate() {
     });
 
     console.log('\n📦 Select a template:\n');
-    console.log('1. Backend  - Express.js + TypeScript + Drizzle ORM');
-    console.log('2. Frontend - React + Vite + Tailwind CSS v4 + shadcn/ui\n');
+    console.log('1. Backend   - Express.js + TypeScript + Drizzle ORM');
+    console.log('2. Frontend  - React + Vite + Tailwind CSS v4 + shadcn/ui');
+    console.log('3. Fullstack - Both Backend and Frontend\n');
 
-    const answer = await rl.question('Enter your choice (1 or 2): ');
+    const answer = await rl.question('Enter your choice (1, 2, or 3): ');
     rl.close();
 
     if (answer === '1' || answer.toLowerCase() === 'backend') {
@@ -87,6 +115,9 @@ async function promptTemplate() {
     if (answer === '2' || answer.toLowerCase() === 'frontend') {
         return 'frontend';
     }
+    if (answer === '3' || answer.toLowerCase() === 'fullstack') {
+        return 'fullstack';
+    }
 
     console.error('Invalid choice. Please run the command again.');
     process.exit(1);
@@ -102,7 +133,7 @@ async function main() {
             templateKey = templateArg.toLowerCase();
             if (!TEMPLATES[templateKey]) {
                 console.error(`Error: Invalid template "${templateArg}"`);
-                console.log('Available templates: backend, frontend');
+                console.log('Available templates: backend, frontend, fullstack');
                 process.exit(1);
             }
         } else {
@@ -111,37 +142,63 @@ async function main() {
         }
 
         const template = TEMPLATES[templateKey];
-        const templateDir = join(templatesDir, template.dir);
-
-        // Verify template directory exists
-        if (!existsSync(templateDir)) {
-            console.error(`Error: Template directory not found: ${templateDir}`);
-            process.exit(1);
-        }
 
         console.log(`\n🚀 Creating ${template.name} project: ${projectName}`);
         console.log(`📁 ${template.description}\n`);
 
-        // Copy template to target directory
-        copyDir(templateDir, targetDir);
-
-        // Update package.json with the new project name
-        const packageJsonPath = join(targetDir, 'package.json');
-        if (existsSync(packageJsonPath)) {
-            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-            packageJson.name = projectName;
-            writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+        // Handle fullstack (multiple templates) or single template
+        if (template.dirs) {
+            // Fullstack: copy each template to a subdirectory
+            for (const dir of template.dirs) {
+                const templateDir = join(templatesDir, dir);
+                if (!existsSync(templateDir)) {
+                    console.error(`Error: Template directory not found: ${templateDir}`);
+                    process.exit(1);
+                }
+                const subTargetDir = join(targetDir, dir);
+                copyDir(templateDir, subTargetDir);
+
+                // Update package.json name for each sub-project
+                const packageJsonPath = join(subTargetDir, 'package.json');
+                if (existsSync(packageJsonPath)) {
+                    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+                    packageJson.name = `${projectName}-${dir}`;
+                    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+                }
+            }
+        } else {
+            // Single template
+            const templateDir = join(templatesDir, template.dir);
+            if (!existsSync(templateDir)) {
+                console.error(`Error: Template directory not found: ${templateDir}`);
+                process.exit(1);
+            }
+            copyDir(templateDir, targetDir);
+
+            // Update package.json with the new project name
+            const packageJsonPath = join(targetDir, 'package.json');
+            if (existsSync(packageJsonPath)) {
+                const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+                packageJson.name = projectName;
+                writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+            }
         }
 
         console.log('✅ Project created successfully!\n');
         console.log('📝 Next steps:');
         console.log(`   cd ${projectName}`);
-        console.log('   pnpm install');
-        console.log('   pnpm dev\n');
+        if (templateKey === 'fullstack') {
+            console.log('   cd backend && pnpm install && pnpm dev');
+            console.log('   cd frontend && pnpm install && pnpm dev\n');
+        } else {
+            console.log('   pnpm install');
+            console.log('   pnpm dev\n');
+        }
 
-        if (templateKey === 'frontend') {
+        if (templateKey === 'frontend' || templateKey === 'fullstack') {
             console.log('💡 Tip: Add shadcn/ui components with:');
-            console.log('   pnpm dlx shadcn@latest add button card dialog\n');
+            const cdPath = templateKey === 'fullstack' ? 'cd frontend && ' : '';
+            console.log(`   ${cdPath}pnpm dlx shadcn@latest add button card dialog\n`);
         }
     } catch (error) {
         console.error('Error creating project:', error.message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totaland/create-starter-kit",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Scaffolding tool for creating new starter-kit projects",
   "type": "module",
   "publishConfig": {
@@ -13,6 +13,10 @@
     "bin",
     "templates"
   ],
+  "scripts": {
+    "sync-templates": "node scripts/sync-templates.js",
+    "prepublishOnly": "node scripts/sync-templates.js"
+  },
   "keywords": [
     "starter-kit",
     "scaffold",
@@ -21,4 +25,4 @@
   "dependencies": {
     "fast-glob": "^3.3.2"
   }
-}
+}