@techstream/quark-create-app 1.6.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.6.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(", ")}`,
+					);
+				}
 
-			const { features } = response;
+				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,
+							},
+						],
+					},
+				]);
 
-			// Handle prompt cancellation (Ctrl+C)
-			if (!features) {
-				console.log(chalk.yellow("\n\u26A0\uFE0F  Setup cancelled."));
-				await fs.remove(targetDir);
-				process.exit(0);
+				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);
+				}
 			}
 
 			// Step 6: Copy selected optional packages
@@ -484,11 +538,11 @@ program
 # Generate strong passwords with: openssl rand -base64 32
 POSTGRES_HOST=localhost
 POSTGRES_PORT=5432
-POSTGRES_USER=quark_user
+POSTGRES_USER=${scope}_user
 POSTGRES_PASSWORD=CHANGE_ME_TO_STRONG_PASSWORD
 POSTGRES_DB=${scope}_dev
 # Optional: Set DATABASE_URL to override the dynamic construction above
-# DATABASE_URL="postgresql://quark_user:CHANGE_ME_TO_STRONG_PASSWORD@localhost:5432/${scope}_dev?schema=public"
+# DATABASE_URL="postgresql://${scope}_user:CHANGE_ME_TO_STRONG_PASSWORD@localhost:5432/${scope}_dev?schema=public"
 
 # --- Redis Configuration ---
 REDIS_HOST=localhost
@@ -501,8 +555,6 @@ REDIS_PORT=6379
 MAIL_HOST=localhost
 MAIL_SMTP_PORT=1025
 MAIL_UI_PORT=8025
-# Optional: Set MAIL_SMTP_URL to override the dynamic construction above
-# MAIL_SMTP_URL="smtp://localhost:1025"
 
 # Production SMTP: Set these instead of MAIL_* when using a real SMTP relay
 # SMTP_HOST=smtp.example.com
@@ -525,6 +577,10 @@ MAIL_UI_PORT=8025
 # In production, set this to your real domain:
 # APP_URL=https://yourdomain.com
 
+# --- Application Identity ---
+# APP_NAME is used in metadata, emails, and page titles.
+APP_NAME=${projectName}
+
 # --- NextAuth Configuration ---
 # ⚠️  CRITICAL: Generate a secure secret with: openssl rand -base64 32
 # This secret is used to encrypt JWT tokens and session data
@@ -617,7 +673,7 @@ STORAGE_PROVIDER=local
 			const envContent = `# --- Database Configuration ---
 POSTGRES_HOST=localhost
 POSTGRES_PORT=${postgresPort}
-POSTGRES_USER=quark_user
+POSTGRES_USER=${scope}_user
 POSTGRES_PASSWORD=${dbPassword}
 POSTGRES_DB=${scope}_dev
 
@@ -630,6 +686,9 @@ MAIL_HOST=localhost
 MAIL_SMTP_PORT=${mailSmtpPort}
 MAIL_UI_PORT=${mailUiPort}
 
+# --- Application Identity ---
+APP_NAME=${projectName}
+
 # --- NextAuth Configuration ---
 NEXTAUTH_SECRET=${nextAuthSecret}
 

package/templates/base-project/apps/web/next.config.js

@@ -1,5 +1,9 @@
 /** @type {import('next').NextConfig} */
 const nextConfig = {
+	// Required for Railway deployment — produces a self-contained build
+	// at .next/standalone that can run without node_modules.
+	output: "standalone",
+
 	// Support workspace package resolution (including @techstream/quark-db which uses
 	// the Prisma driver-adapter pattern — pure JS, no native engine binary)
 	transpilePackages: [

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

@@ -16,18 +16,18 @@
 		"@techstream/quark-db": "workspace:*",
 		"@techstream/quark-jobs": "workspace:*",
 		"@techstream/quark-ui": "workspace:*",
-		"@prisma/client": "^7.3.0",
+		"@prisma/client": "^7.4.0",
 		"next": "16.1.6",
 		"next-auth": "5.0.0-beta.30",
 		"pg": "^8.18.0",
-		"react": "19.2.0",
-		"react-dom": "19.2.0",
+		"react": "19.2.4",
+		"react-dom": "19.2.4",
 		"zod": "^4.3.6"
 	},
 	"devDependencies": {
-		"@tailwindcss/postcss": "^4.1.18",
-		"@types/node": "^20.19.33",
-		"tailwindcss": "^4.1.18",
+		"@tailwindcss/postcss": "^4.2.0",
+		"@types/node": "^25.2.3",
+		"tailwindcss": "^4.2.0",
 		"@techstream/quark-config": "workspace:*"
 	}
 }

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

@@ -0,0 +1,16 @@
+{
+	"$schema": "https://railway.com/railway.schema.json",
+	"build": {
+		"builder": "RAILPACK",
+		"buildCommand": "pnpm install --frozen-lockfile && pnpm db:generate && pnpm build",
+		"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,
+		"restartPolicyType": "ON_FAILURE",
+		"restartPolicyMaxRetries": 5
+	}
+}