@techstream/quark-create-app 1.7.0 → 1.8.0

package/README.md

@@ -42,6 +42,67 @@ Aliases:
 - `create-quark-app`
 - `quark-update`
 
+## Usage with Flags
+
+The CLI supports non-interactive mode with custom options for automation and CI/CD workflows.
+
+### Non-Interactive Mode
+
+Skip all interactive prompts and use defaults:
+
+```bash
+# Create project without prompts
+npx @techstream/quark-create-app my-app --no-prompts
+```
+
+### Custom Features
+
+Specify which optional packages to include (default: `ui,jobs`):
+
+```bash
+# Only include UI package
+npx @techstream/quark-create-app my-app --no-prompts --features ui
+
+# Include both UI and Jobs
+npx @techstream/quark-create-app my-app --no-prompts --features ui,jobs
+
+# Minimal setup (no optional packages)
+npx @techstream/quark-create-app my-app --no-prompts --features ""
+```
+
+### Skip Installation Steps
+
+Create the project structure without running package installation:
+
+```bash
+# Create project but skip pnpm install
+npx @techstream/quark-create-app my-app --no-prompts --skip-install
+
+# Useful for CI/CD where you'll install dependencies separately
+```
+
+### Docker Cleanup
+
+Control whether to remove Docker volumes from previous cleanup:
+
+```bash
+# Keep Docker working directories (useful in CI/CD)
+npx @techstream/quark-create-app my-app --no-prompts --skip-docker
+```
+
+### Complete Example: Full Automation
+
+```bash
+# Create, install, and setup everything automatically
+npx @techstream/quark-create-app my-app \
+  --no-prompts \
+  --features ui,jobs \
+  && cd my-app \
+  && docker compose up -d \
+  && pnpm db:migrate \
+  && pnpm dev
+```
+
 ## Common Tasks
 
 - **Update Quark packages**: `quark-update` or `pnpm update @techstream/quark-*`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techstream/quark-create-app",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "type": "module",
   "bin": {
     "quark-create-app": "src/index.js",
@@ -33,7 +33,10 @@
     "test": "node test-cli.js",
     "test:build": "node test-build.js",
     "test:e2e": "node test-e2e.js",
+    "test:e2e:full": "node test-e2e-full.js",
     "test:integration": "node test-integration.js",
-    "test:all": "node test-all.js"
+    "test:flags": "node --test test-flags.js",
+    "test:all": "node test-all.js",
+    "check:perf": "node scripts/check-e2e-perf.js"
   }
 }

package/src/index.js

@@ -254,7 +254,15 @@ function validateProjectName(name) {
 
 program
 	.argument("<project-name>", "Name of the project to create")
-	.action(async (projectName) => {
+	.option(
+		"--no-prompts",
+		"Skip interactive prompts and use default/provided values",
+	)
+	.option(
+		"--features <features>",
+		"Comma-separated list of optional features to include (ui,jobs)",
+	)
+	.action(async (projectName, options) => {
 		console.log(
 			chalk.blue.bold(
 				`\n\uD83D\uDE80 Creating your new Quark project: ${projectName}\n`,
@@ -314,16 +322,25 @@ program
 
 		// Check if directory already exists
 		if (await fs.pathExists(targetDir)) {
-			const { overwrite } = await prompts({
-				type: "confirm",
-				name: "overwrite",
-				message: `Directory "${projectName}" already exists. Remove it and recreate?`,
-				initial: false,
-			});
+			if (!options.prompts) {
+				// In non-interactive mode, automatically remove existing directory
+				console.log(
+					chalk.yellow(
+						`  Directory "${projectName}" already exists. Removing... (non-interactive mode)`,
+					),
+				);
+			} else {
+				const { overwrite } = await prompts({
+					type: "confirm",
+					name: "overwrite",
+					message: `Directory "${projectName}" already exists. Remove it and recreate?`,
+					initial: false,
+				});
 
-			if (!overwrite) {
-				console.log(chalk.yellow("Aborted."));
-				process.exit(1);
+				if (!overwrite) {
+					console.log(chalk.yellow("Aborted."));
+					process.exit(1);
+				}
 			}
 
 			// Stop any running Docker containers for this project
@@ -379,35 +396,72 @@ program
 			}
 
 			// Step 5: Ask which optional features to eject
-			console.log(chalk.cyan("\n  🎯 Configuring optional features...\n"));
-			const response = await prompts([
-				{
-					type: "multiselect",
-					name: "features",
-					message: "Which optional packages would you like to include?",
-					instructions: false,
-					choices: [
-						{
-							title: "UI Components (packages/ui)",
-							value: "ui",
-							selected: true,
-						},
-						{
-							title: "Job Definitions (packages/jobs)",
-							value: "jobs",
-							selected: true,
-						},
-					],
-				},
-			]);
+			let features;
+			if (!options.prompts && options.features) {
+				// Parse features from CLI flag
+				console.log(chalk.cyan("\n  🎯 Configuring optional features..."));
+				const validFeatures = ["ui", "jobs"];
+				features = options.features
+					.split(",")
+					.map((f) => f.trim())
+					.filter((f) => f.length > 0);
+
+				// Validate features
+				const invalidFeatures = features.filter(
+					(f) => !validFeatures.includes(f),
+				);
+				if (invalidFeatures.length > 0) {
+					throw new Error(
+						`Invalid features: ${invalidFeatures.join(", ")}. Valid options are: ${validFeatures.join(", ")}`,
+					);
+				}
+
+				console.log(
+					chalk.green(
+						`  Selected features: ${features.join(", ") || "none"} (non-interactive mode)`,
+					),
+				);
+			} else if (!options.prompts) {
+				// Use defaults when --no-prompts is set without --features
+				console.log(chalk.cyan("\n  🎯 Configuring optional features..."));
+				features = ["ui", "jobs"]; // Default to both
+				console.log(
+					chalk.green(
+						`  Using default features: ${features.join(", ")} (non-interactive mode)`,
+					),
+				);
+			} else {
+				// Interactive prompt
+				console.log(chalk.cyan("\n  🎯 Configuring optional features...\n"));
+				const response = await prompts([
+					{
+						type: "multiselect",
+						name: "features",
+						message: "Which optional packages would you like to include?",
+						instructions: false,
+						choices: [
+							{
+								title: "UI Components (packages/ui)",
+								value: "ui",
+								selected: true,
+							},
+							{
+								title: "Job Definitions (packages/jobs)",
+								value: "jobs",
+								selected: true,
+							},
+						],
+					},
+				]);
 
-			const { features } = response;
+				features = response.features;
 
-			// Handle prompt cancellation (Ctrl+C)
-			if (!features) {
-				console.log(chalk.yellow("\n\u26A0\uFE0F  Setup cancelled."));
-				await fs.remove(targetDir);
-				process.exit(0);
+				// Handle prompt cancellation (Ctrl+C)
+				if (!features) {
+					console.log(chalk.yellow("\n\u26A0\uFE0F  Setup cancelled."));
+					await fs.remove(targetDir);
+					process.exit(0);
+				}
 			}
 
 			// Step 6: Copy selected optional packages

package/templates/base-project/apps/web/railway.json

@@ -6,6 +6,7 @@
 		"watchPatterns": ["apps/web/**", "packages/**"]
 	},
 	"deploy": {
+		"releaseCommand": "pnpm --filter @techstream/quark-db exec prisma migrate deploy",
 		"startCommand": "node apps/web/.next/standalone/server.js",
 		"healthcheckPath": "/api/health",
 		"healthcheckTimeout": 30,