a3-stack-cli 0.1.4 → 0.1.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "a3-stack-cli",
-  "version": "0.1.4",
-  "description": "A3 Stack CLI - Create modern full-stack apps with SvelteKit, Better Auth, and Kysely",
+  "version": "0.1.6",
+  "description": "A3 Stack CLI - Create modern full-stack apps with SvelteKit, Better Auth, Convex, and Kysely",
   "type": "module",
   "bin": {
     "a3": "./src/index.ts"
@@ -36,6 +36,7 @@
     "a3-stack",
     "sveltekit",
     "better-auth",
+    "convex",
     "kysely",
     "cli",
     "scaffold"

package/src/commands/create.ts

@@ -2,11 +2,11 @@ import { defineCommand } from 'citty';
 import consola from 'consola';
 import prompts from 'prompts';
 import pc from 'picocolors';
-import { downloadTemplate, listTemplates, processTemplate } from '../lib/template';
+import { downloadTemplate, getTemplateInfo, listTemplates, processTemplate } from '../lib/template';
 import { initGit, isGitInstalled } from '../lib/git';
 import { installDependencies, runPostInstall } from '../lib/setup';
 import { resolve } from 'path';
-import { existsSync } from 'fs';
+import { existsSync, mkdirSync, statSync } from 'fs';
 
 export const createCommand = defineCommand({
   meta: {
@@ -22,7 +22,12 @@ export const createCommand = defineCommand({
     template: {
       type: 'string',
       alias: 't',
-      description: 'Template to use (e.g., kysely)',
+      description: 'Template to use (e.g., convex)',
+    },
+    path: {
+      type: 'string',
+      alias: 'p',
+      description: 'Directory where the project folder should be created',
     },
     git: {
       type: 'boolean',
@@ -49,15 +54,8 @@ export const createCommand = defineCommand({
 
     // Get available templates
     const templates = await listTemplates();
-
-    // Check if target directory already exists (if name provided)
-    if (args.name) {
-      const targetDir = resolve(process.cwd(), args.name);
-      if (existsSync(targetDir)) {
-        consola.error(`Directory ${pc.cyan(args.name)} already exists`);
-        return;
-      }
-    }
+    const invocationCwd = process.env.INIT_CWD ? resolve(process.env.INIT_CWD) : process.cwd();
+    const resolveFromInvocation = (inputPath: string) => resolve(invocationCwd, inputPath);
 
     // Interactive prompts
     const response = await prompts(
@@ -72,9 +70,19 @@ export const createCommand = defineCommand({
             if (!/^[a-z0-9-_]+$/i.test(value)) {
               return 'Project name can only contain letters, numbers, dashes, and underscores';
             }
-            const targetDir = resolve(process.cwd(), value);
-            if (existsSync(targetDir)) {
-              return `Directory ${value} already exists`;
+            return true;
+          },
+        },
+        {
+          type: args.path ? null : 'text',
+          name: 'path',
+          message: 'Project location:',
+          initial: invocationCwd,
+          validate: (value: string) => {
+            if (!value) return 'Project location is required';
+            const baseDir = resolveFromInvocation(value);
+            if (existsSync(baseDir) && !statSync(baseDir).isDirectory()) {
+              return `${baseDir} exists and is not a directory`;
             }
             return true;
           },
@@ -112,15 +120,31 @@ export const createCommand = defineCommand({
 
     const projectName = args.name || response.name;
     const template = args.template || response.template;
+    const projectPathInput = args.path || response.path || '.';
     const shouldInitGit = args.git !== false && response.git !== false;
     const shouldInstall = args.install !== false && response.install !== false;
+    const templateInfo = await getTemplateInfo(template || '');
 
-    if (!projectName || !template) {
+    if (!projectName || !template || !projectPathInput) {
       consola.error('Missing required options');
       return;
     }
 
-    const targetDir = resolve(process.cwd(), projectName);
+    const baseDir = resolveFromInvocation(projectPathInput);
+    if (existsSync(baseDir) && !statSync(baseDir).isDirectory()) {
+      consola.error(`${pc.cyan(baseDir)} exists and is not a directory`);
+      return;
+    }
+
+    if (!existsSync(baseDir)) {
+      mkdirSync(baseDir, { recursive: true });
+    }
+
+    const targetDir = resolve(baseDir, projectName);
+    if (existsSync(targetDir)) {
+      consola.error(`Directory ${pc.cyan(targetDir)} already exists`);
+      return;
+    }
 
     console.log('');
     consola.start(`Creating ${pc.cyan(projectName)} with ${pc.green(template)} template...`);
@@ -134,6 +158,17 @@ export const createCommand = defineCommand({
       return;
     }
 
+    const packageJsonPath = resolve(targetDir, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+      consola.error(
+        `Downloaded template is invalid (missing package.json at ${pc.cyan(packageJsonPath)}).`
+      );
+      consola.info(
+        'This usually means the selected template path is empty or not available in the remote repository.'
+      );
+      return;
+    }
+
     // Process template (replace placeholders)
     try {
       await processTemplate(targetDir, { projectName });
@@ -163,6 +198,7 @@ export const createCommand = defineCommand({
       try {
         await installDependencies(targetDir);
         consola.success('Installed dependencies');
+        await runPostInstall(targetDir, templateInfo?.postInstall);
       } catch (error) {
         consola.warn(`Failed to install dependencies: ${error}`);
         consola.info('You can install them manually with: bun install');
@@ -182,13 +218,22 @@ export const createCommand = defineCommand({
     console.log('');
     consola.info(`${pc.bold('Next steps:')}`);
     console.log('');
-    console.log(`  ${pc.cyan('cd')} ${projectName}`);
+    console.log(`  ${pc.cyan('cd')} ${targetDir}`);
 
     if (!shouldInstall) {
       console.log(`  ${pc.cyan('bun install')}`);
+      if (templateInfo?.postInstall) {
+        console.log(`  ${pc.cyan(templateInfo.postInstall)}  ${pc.dim('# Configure environment')}`);
+      }
+    } else if (template === 'convex') {
+      console.log(
+        `  ${pc.dim('# Setup script ran. Next, initialize Convex in another terminal:')}`
+      );
     }
 
-    console.log(`  ${pc.cyan('bun run scripts/setup-project.ts')}  ${pc.dim('# Configure environment')}`);
+    if (template === 'convex') {
+      console.log(`  ${pc.cyan('bun run convex:dev')}`);
+    }
     console.log(`  ${pc.cyan('bun run dev')}`);
     console.log('');
     consola.info(`Visit ${pc.cyan('http://localhost:5173')} to see your app`);

package/src/commands/templates.ts

@@ -26,7 +26,7 @@ export const templatesCommand = defineCommand({
       console.log('');
     }
 
-    consola.info(`Create a project with: ${pc.cyan('a3 create my-app --template kysely')}`);
+    consola.info(`Create a project with: ${pc.cyan('a3 create my-app --template convex')}`);
     console.log('');
   },
 });

package/src/index.ts

@@ -7,7 +7,7 @@ const main = defineCommand({
   meta: {
     name: 'a3',
     version: '0.1.1',
-    description: 'A3 Stack CLI - Create modern full-stack apps with SvelteKit, Better Auth, and Kysely',
+    description: 'A3 Stack CLI - Create modern full-stack apps with SvelteKit, Better Auth, and Convex',
   },
   subCommands: {
     create: createCommand,

package/src/lib/template.ts

@@ -25,6 +25,22 @@ const GITHUB_REPO = 'AdamAugustinsky/a3-stack';
  */
 export async function listTemplates(): Promise<Template[]> {
   return [
+    {
+      name: 'convex',
+      displayName: 'A3 Stack + Convex',
+      description: 'SvelteKit 5 + Better Auth + Convex',
+      features: [
+        'Real-time backend with Convex',
+        'Better Auth authentication',
+        'Organization/multi-tenant support',
+        'shadcn-svelte components',
+        'TailwindCSS v4',
+        'Remote functions (experimental)',
+      ],
+      icon: 'database',
+      version: '1.0.0',
+      postInstall: 'bun run scripts/setup-project.ts',
+    },
     {
       name: 'kysely',
       displayName: 'A3 Stack + Kysely',
@@ -86,12 +102,13 @@ export async function processTemplate(
     // template.json might not exist, that's fine
   }
 
-  // Remove .claude directory if it exists (AI assistant specific configs)
+  // Remove AI assistant specific config directories if they exist
   try {
     const { rm } = await import('fs/promises');
     await rm(join(dir, '.claude'), { recursive: true, force: true });
+    await rm(join(dir, '.agents'), { recursive: true, force: true });
   } catch {
-    // .claude might not exist, that's fine
+    // AI config directories might not exist, that's fine
   }
 
   // Remove CLAUDE.md, AGENTS.md if they exist