@techstream/quark-create-app 1.5.0 → 1.5.2

package/README.md

@@ -12,7 +12,7 @@ The CLI scaffolds a complete project structure with:
 - **Next.js** web application
 - **Prisma** database schema and migrations
 - **BullMQ** job queues
-- **Docker Compose** setup (PostgreSQL, Redis, Mailhog)
+- **Docker Compose** setup (PostgreSQL, Redis, Mailpit)
 - **JavaScript** monorepo with `pnpm` workspaces
 
 ## Quick Setup
@@ -20,7 +20,6 @@ The CLI scaffolds a complete project structure with:
 ```bash
 cd my-awesome-app
 docker compose up -d
-pnpm db:generate
 pnpm db:migrate
 pnpm dev
 ```

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@techstream/quark-create-app",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "type": "module",
   "bin": {
     "quark-create-app": "src/index.js",
-    "create-quark-app": "src/index.js"
+    "create-quark-app": "src/index.js",
+    "quark-update": "src/index.js"
   },
   "files": [
     "src",

package/src/index.js

@@ -444,12 +444,12 @@ REDIS_PORT=6379
 # Optional: Set REDIS_URL to override the dynamic construction above
 # REDIS_URL="redis://localhost:6379"
 
-# --- Mailhog Configuration ---
-MAILHOG_HOST=localhost
-MAILHOG_SMTP_PORT=1025
-MAILHOG_UI_PORT=8025
-# Optional: Set MAILHOG_SMTP_URL to override the dynamic construction above
-# MAILHOG_SMTP_URL="smtp://localhost:1025"
+# --- Mail Configuration (Mailpit in development) ---
+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"
 
 # --- Application URL ---
 # In development, APP_URL is derived automatically from PORT — no need to set it.
@@ -544,9 +544,9 @@ REDIS_HOST=localhost
 REDIS_PORT=${redisPort}
 
 # --- Mail Configuration ---
-MAILHOG_HOST=localhost
-MAILHOG_SMTP_PORT=${mailSmtpPort}
-MAILHOG_UI_PORT=${mailUiPort}
+MAIL_HOST=localhost
+MAIL_SMTP_PORT=${mailSmtpPort}
+MAIL_UI_PORT=${mailUiPort}
 
 # --- NextAuth Configuration ---
 NEXTAUTH_SECRET=${nextAuthSecret}
@@ -637,7 +637,7 @@ STORAGE_PROVIDER=local
 			console.log(chalk.cyan("Next steps:"));
 			console.log(chalk.white(`  1. cd ${projectName}`));
 			console.log(chalk.white(`  2. docker compose up -d`));
-			console.log(chalk.white(`  3. pnpm --filter db db:push`));
+			console.log(chalk.white(`  3. pnpm db:migrate`));
 			console.log(chalk.white(`  4. pnpm dev\n`));
 
 			console.log(chalk.cyan("Important:"));
@@ -647,7 +647,7 @@ STORAGE_PROVIDER=local
 				),
 			);
 			console.log(
-				chalk.white(`  • Use 'quark-update' to upgrade Quark packages\n`),
+				chalk.white(`  • Or run: npx @techstream/quark-create-app update\n`),
 			);
 
 			console.log(chalk.cyan("Learn more:"));

package/templates/base-project/README.md

@@ -6,15 +6,19 @@ A modern, scalable monorepo built with Quark.
 
 ```bash
 pnpm install
+docker compose up -d
+pnpm db:migrate
 pnpm dev
 ```
 
+Open http://localhost:3000
+
 ## Services
 
 - **Docker**: `docker compose up -d`
-- **Database**: PostgreSQL on port 5432
-- **Cache**: Redis on port 6379
-- **Email**: Mailhog UI on port 8025
+- **Database**: PostgreSQL
+- **Cache**: Redis
+- **Email**: Mailpit
 
 ## Development
 
@@ -29,6 +33,16 @@ pnpm test
 pnpm lint
 ```
 
+## Database
+
+| Task | Command |
+|------|--------|
+| Run migrations | `pnpm db:migrate` |
+| Push schema (no migration) | `pnpm db:push` |
+| Generate Prisma client | `pnpm db:generate` |
+| Seed database | `pnpm db:seed` |
+| Open Prisma Studio | `pnpm db:studio` |
+
 ## Structure
 
 - `apps/` - Applications (web, worker, etc.)

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

@@ -1,6 +1,6 @@
 {
-	"name": "@quark/web",
-	"version": "0.1.0",
+	"name": "@techstream/quark-web",
+	"version": "1.0.0",
 	"type": "module",
 	"private": true,
 	"scripts": {
@@ -21,7 +21,8 @@
 		"next-auth": "5.0.0-beta.30",
 		"pg": "^8.18.0",
 		"react": "19.2.0",
-		"react-dom": "19.2.0"
+		"react-dom": "19.2.0",
+		"zod": "^4.3.6"
 	},
 	"devDependencies": {
 		"@techstream/quark-config": "workspace:*",

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

@@ -1,7 +1,8 @@
 {
-	"name": "@quark/worker",
+	"name": "@techstream/quark-worker",
 	"version": "1.0.0",
 	"type": "module",
+	"private": true,
 	"description": "",
 	"main": "index.js",
 	"scripts": {

package/templates/base-project/docker-compose.yml

@@ -11,6 +11,11 @@ services:
       POSTGRES_DB: ${POSTGRES_DB}
     volumes:
       - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-quark_user}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
 
   # --- 2. Redis Cache & Job Queue ---
   redis:
@@ -21,6 +26,11 @@ services:
     command: redis-server --appendonly yes
     volumes:
       - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
 
   # --- 3. Mailpit (Local SMTP Server) ---
   mailpit:
@@ -28,9 +38,14 @@ services:
     restart: always
     ports:
       # SMTP port (used by application to send mail)
-      - "${MAILHOG_SMTP_PORT:-1025}:1025"
+      - "${MAIL_SMTP_PORT:-1025}:1025"
       # Web UI port (to view sent emails)
-      - "${MAILHOG_UI_PORT:-8025}:8025"
+      - "${MAIL_UI_PORT:-8025}:8025"
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:8025"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
 
 volumes:
   postgres_data:

package/templates/base-project/package.json

@@ -11,7 +11,11 @@
 		"test": "turbo run test",
 		"docker:up": "docker compose up -d",
 		"docker:down": "docker compose down",
-		"db:generate": "turbo run db:generate"
+		"db:generate": "turbo run db:generate",
+		"db:migrate": "turbo run db:migrate",
+		"db:push": "turbo run db:push",
+		"db:seed": "turbo run db:seed",
+		"db:studio": "turbo run db:studio"
 	},
 	"keywords": [],
 	"author": "",

package/templates/base-project/packages/db/package.json

@@ -23,11 +23,11 @@
 	"devDependencies": {
 		"@techstream/quark-config": "workspace:*",
 		"bcryptjs": "^3.0.3",
-		"prisma": "^7.3.0"
+		"prisma": "^7.4.0"
 	},
 	"dependencies": {
-		"@prisma/adapter-pg": "^7.3.0",
-		"@prisma/client": "^7.3.0",
+		"@prisma/adapter-pg": "^7.4.0",
+		"@prisma/client": "^7.4.0",
 		"dotenv": "^17.2.4",
 		"pg": "^8.18.0",
 		"zod": "^4.3.6"

package/templates/base-project/turbo.json

@@ -2,7 +2,7 @@
 	"$schema": "https://turbo.build/schema.json",
 	"tasks": {
 		"build": {
-			"dependsOn": ["^build"],
+			"dependsOn": ["^build", "db:generate"],
 			"outputs": ["dist/**", ".next/**"],
 			"env": ["NODE_ENV"]
 		},
@@ -17,6 +17,19 @@
 			"cache": false,
 			"outputs": ["node_modules/.prisma/client"]
 		},
+		"db:migrate": {
+			"cache": false
+		},
+		"db:push": {
+			"cache": false
+		},
+		"db:seed": {
+			"cache": false
+		},
+		"db:studio": {
+			"cache": false,
+			"persistent": true
+		},
 		"dev": {
 			"cache": false,
 			"persistent": true,
@@ -29,9 +42,9 @@
 				"POSTGRES_DB",
 				"REDIS_HOST",
 				"REDIS_PORT",
-				"MAILHOG_HOST",
-				"MAILHOG_SMTP_PORT",
-				"MAILHOG_UI_PORT",
+				"MAIL_HOST",
+				"MAIL_SMTP_PORT",
+				"MAIL_UI_PORT",
 				"NEXTAUTH_SECRET",
 				"APP_URL",
 				"WORKER_CONCURRENCY",

package/templates/config/src/index.js

@@ -14,7 +14,7 @@ export const config = {
 	},
 	email: {
 		from: process.env.EMAIL_FROM || "noreply@myquarkapp.com",
-		provider: process.env.EMAIL_PROVIDER || "mailhog",
+		provider: process.env.EMAIL_PROVIDER || "smtp",
 	},
 };
 

package/templates/config/src/validate-env.js

@@ -22,11 +22,11 @@ const envSchema = {
 	REDIS_HOST: { required: false, description: "Redis host" },
 	REDIS_PORT: { required: false, description: "Redis port" },
 
-	// Mailhog
-	MAILHOG_SMTP_URL: { required: false, description: "Mailhog SMTP URL" },
-	MAILHOG_HOST: { required: false, description: "Mailhog host" },
-	MAILHOG_SMTP_PORT: { required: false, description: "Mailhog SMTP port" },
-	MAILHOG_UI_PORT: { required: false, description: "Mailhog UI port" },
+	// Mail (local SMTP server)
+	MAIL_SMTP_URL: { required: false, description: "Mail SMTP URL" },
+	MAIL_HOST: { required: false, description: "Mail host" },
+	MAIL_SMTP_PORT: { required: false, description: "Mail SMTP port" },
+	MAIL_UI_PORT: { required: false, description: "Mail UI port" },
 
 	// NextAuth
 	NEXTAUTH_SECRET: {