${title}

[\s\S]*?Backend Connection Status[\s\S]*?<\/div>/g, "") .replace(/\s*

\s*]*>Backend Connection Status[\s\S]*?<\/p>\s*<\/div>\s*<\/div>\s*<\/div>/g, "") .replace(/\s*

\s*]*>Backend Connection Status[\s\S]*?<\/p>\s*<\/div>\s*<\/div>\s*<\/div>/g, "") .replace(/\s*\{users\.length > 0 && $[\s\S]*?<\/div>\s*$\}/g, "") .replace(/\s*

/g, ""); return stripped.replace( /,\s*useAuth(?=\s*\}\s*from\s*["']@clerk\/react["'];?)/g, "", ); } async function generateReactProject(options: ProjectOptions) { console.log(`\n🚀 Scaffolding React + Vite...`); const targetDir = join(process.cwd(), options.projectName); await mkdir(join(targetDir, "src", "lib"), { recursive: true }); const viteConfig = await readTemplate("react/vite.config.ts.stub"); const indexCss = await readTemplate("react/index.css.stub"); if (options.authTarget === "clerk") { let clerkProvider = await readTemplate("react/clerk-provider.tsx.stub"); if (!options.backendFramework) clerkProvider = stripBackendStatus(clerkProvider); await Bun.write(join(targetDir, "src", "App.tsx"), clerkProvider); } else if (options.authTarget === "supabase") { const supabaseTs = await readTemplate("react/supabase.ts.stub"); const authContextTsx = await readTemplate("react/AuthContext.tsx.stub"); let appTsx = await readTemplate("react/App.tsx.stub"); if (!options.backendFramework) appTsx = stripBackendStatus(appTsx); await Bun.write(join(targetDir, "src", "lib", "supabase.ts"), supabaseTs); await Bun.write(join(targetDir, "src", "lib", "AuthContext.tsx"), authContextTsx); await Bun.write(join(targetDir, "src", "App.tsx"), appTsx); } else { // Local Auth App.tsx let localAppTsx = await readTemplate("react/App.local.tsx.stub"); if (!options.backendFramework) localAppTsx = stripBackendStatus(localAppTsx); await Bun.write(join(targetDir, "src", "App.tsx"), localAppTsx); } await Bun.write(join(targetDir, "vite.config.ts"), viteConfig); await Bun.write(join(targetDir, "src", "index.css"), indexCss); await writeReactScaffold(targetDir); const pkgJson = await createVitePackageJson(options.projectName, "react", options.authTarget); await writeJson(join(targetDir, "package.json"), pkgJson); const apiUrl = resolveFrontendApiUrl(options.backendFramework); if (options.authTarget === "clerk") { const envContent = `VITE_API_URL="${apiUrl}"\nVITE_CLERK_PUBLISHABLE_KEY="YOUR_CLERK_PUBLISHABLE_KEY"\n`; await Bun.write(join(targetDir, ".env"), envContent); await Bun.write(join(targetDir, ".env.example"), envContent); } else if (options.authTarget === "supabase") { const envContent = `VITE_API_URL="${apiUrl}"\nVITE_SUPABASE_URL="https://YOUR_PROJECT_REF.supabase.co"\nVITE_SUPABASE_ANON_KEY="YOUR_ANON_KEY"\n`; await Bun.write(join(targetDir, ".env"), envContent); await Bun.write(join(targetDir, ".env.example"), envContent); } else { await Bun.write(join(targetDir, ".env"), `VITE_API_URL="${apiUrl}"\n`); } } async function generateVueProject(options: ProjectOptions) { console.log(`\n🚀 Scaffolding Vue + Vite...`); const targetDir = join(process.cwd(), options.projectName); await mkdir(join(targetDir, "src", "lib"), { recursive: true }); const viteConfig = await readTemplate("vue/vite.config.ts.stub"); const styleCss = await readTemplate("vue/style.css.stub"); if (options.authTarget === "clerk") { const clerkPlugin = await readTemplate("vue/clerk-plugin.ts.stub"); let appVue = await readTemplate("vue/App.clerk.vue.stub"); if (!options.backendFramework) appVue = stripBackendStatus(appVue); await Bun.write(join(targetDir, "src", "lib", "clerk.ts"), clerkPlugin); await Bun.write(join(targetDir, "src", "App.vue"), appVue); await Bun.write(join(targetDir, "src", "main.ts"), `import { createApp } from 'vue' import './style.css' import App from './App.vue' import { setupClerk } from './lib/clerk' const app = createApp(App) setupClerk(app) app.mount('#app')`); } else if (options.authTarget === "supabase") { const supabaseTs = await readTemplate("vue/supabase.ts.stub"); const authTs = await readTemplate("vue/auth.ts.stub"); let appVue = await readTemplate("vue/App.vue.stub"); if (!options.backendFramework) appVue = stripBackendStatus(appVue); await Bun.write(join(targetDir, "src", "lib", "supabase.ts"), supabaseTs); await Bun.write(join(targetDir, "src", "lib", "auth.ts"), authTs); await Bun.write(join(targetDir, "src", "App.vue"), appVue); } else { let localAppVue = await readTemplate("vue/App.local.vue.stub"); if (!options.backendFramework) localAppVue = stripBackendStatus(localAppVue); await Bun.write(join(targetDir, "src", "App.vue"), localAppVue); } await Bun.write(join(targetDir, "vite.config.ts"), viteConfig); await Bun.write(join(targetDir, "src", "style.css"), styleCss); await writeVueScaffold(targetDir, options.authTarget === "clerk"); const pkgJson = await createVitePackageJson(options.projectName, "vue", options.authTarget); await writeJson(join(targetDir, "package.json"), pkgJson); const apiUrl = resolveFrontendApiUrl(options.backendFramework); if (options.authTarget === "clerk") { const envContent = `VITE_API_URL="${apiUrl}"\nVITE_CLERK_PUBLISHABLE_KEY="YOUR_CLERK_PUBLISHABLE_KEY"\n`; await Bun.write(join(targetDir, ".env"), envContent); await Bun.write(join(targetDir, ".env.example"), envContent); } else if (options.authTarget === "supabase") { const envContent = `VITE_API_URL="${apiUrl}"\nVITE_SUPABASE_URL="https://YOUR_PROJECT_REF.supabase.co"\nVITE_SUPABASE_ANON_KEY="YOUR_ANON_KEY"\n`; await Bun.write(join(targetDir, ".env"), envContent); await Bun.write(join(targetDir, ".env.example"), envContent); } else { await Bun.write(join(targetDir, ".env"), `VITE_API_URL="${apiUrl}"\n`); } } async function generatePythonProject(options: ProjectOptions) { const targetDir = join(process.cwd(), options.projectName); console.log(`\n🚀 Scaffolding Python (FastAPI)...`); await copyDirectoryRecursive( "python", targetDir, { "qwykz-app": options.projectName } ); const jwtSecret = generateJwtSecret(); const dbPassword = generateDbPassword(); let envContent = await resolveEnvFile(options.dbTarget, options.projectName, jwtSecret, dbPassword, options.authTarget, options.cachingTarget, options.dbPort, options.redisPort); envContent = envContent.replace('?schema=public', ''); if (options.cachingTarget !== "none") { const redisStub = await readTemplate("python/redis.py.stub"); await Bun.write(join(targetDir, "app/core/redis.py"), redisStub); const reqPath = join(targetDir, "requirements.txt"); const reqText = await Bun.file(reqPath).text(); await Bun.write(reqPath, reqText + "redis>=5.0.1\n"); } if (options.dbTarget === "docker" || options.cachingTarget === "docker") { const dc = await resolveDockerCompose(options.projectName, dbPassword, options.dbTarget, options.cachingTarget, options.dbPort, options.redisPort); await Bun.write(join(targetDir, "docker-compose.yml"), dc); } await Bun.write(join(targetDir, ".env"), envContent); } async function generateGoProject(options: ProjectOptions) { const targetDir = join(process.cwd(), options.projectName); console.log(`\n🚀 Scaffolding Go (Fiber)...`); await copyDirectoryRecursive( "go", targetDir, { "qwykz-app": options.projectName } ); const jwtSecret = generateJwtSecret(); const dbPassword = generateDbPassword(); let envContent = await resolveEnvFile(options.dbTarget, options.projectName, jwtSecret, dbPassword, options.authTarget, options.cachingTarget, options.dbPort, options.redisPort); envContent = envContent.replace('?schema=public', ''); if (options.cachingTarget !== "none") { const redisStub = await readTemplate("go/redis.go.stub"); await Bun.spawn(["mkdir", "-p", join(targetDir, "internal/cache")]).exited; await Bun.write(join(targetDir, "internal/cache/redis.go"), redisStub); const modPath = join(targetDir, "go.mod"); const modText = await Bun.file(modPath).text(); await Bun.write(modPath, modText + "\nrequire github.com/redis/go-redis/v9 v9.5.1\n"); } if (options.dbTarget === "docker" || options.cachingTarget === "docker") { const dc = await resolveDockerCompose(options.projectName, dbPassword, options.dbTarget, options.cachingTarget, options.dbPort, options.redisPort); await Bun.write(join(targetDir, "docker-compose.yml"), dc); } await Bun.write(join(targetDir, ".env"), envContent); } async function generateRustProject(options: ProjectOptions) { const targetDir = join(process.cwd(), options.projectName); console.log(`\n🚀 Scaffolding Rust (Axum)...`); await copyDirectoryRecursive( "rust", targetDir, { "qwykz-app": options.projectName } ); const jwtSecret = generateJwtSecret(); const dbPassword = generateDbPassword(); let envContent = await resolveEnvFile(options.dbTarget, options.projectName, jwtSecret, dbPassword, options.authTarget, options.cachingTarget, options.dbPort, options.redisPort); if (options.cachingTarget !== "none") { const redisStub = await readTemplate("rust/redis.rs.stub"); await Bun.spawn(["mkdir", "-p", join(targetDir, "src/cache")]).exited; await Bun.write(join(targetDir, "src/cache/mod.rs"), "pub mod redis;\n"); await Bun.write(join(targetDir, "src/cache/redis.rs"), redisStub); const cargoPath = join(targetDir, "Cargo.toml"); const cargoText = await Bun.file(cargoPath).text(); await Bun.write(cargoPath, cargoText + "redis = { version = \"0.25.3\", features = [\"tokio-comp\", \"tokio-rustls-comp\"] }\n"); const mainPath = join(targetDir, "src/main.rs"); const mainText = await Bun.file(mainPath).text(); await Bun.write(mainPath, mainText.replace("mod db;\n", "mod db;\npub mod cache;\n")); const usersPath = join(targetDir, "src/api/handlers/users.rs"); await Bun.write(usersPath, `use axum::{ extract::State, http::StatusCode, Json, }; use serde::{Deserialize, Serialize}; use sqlx::FromRow; use redis::AsyncCommands; use crate::api::AppState; #[derive(Serialize, Deserialize, FromRow)] pub struct UserResponse { pub id: uuid::Uuid, pub email: String, pub name: Option, pub role: String, } pub async fn get_users( State(state): State, ) -> Result>, (StatusCode, String)> { let client = crate::cache::redis::get_client(); if let Ok(mut con) = client.get_multiplexed_async_connection().await { if let Ok(cached_users) = con.get::<_, String>("users:all").await { if let Ok(users) = serde_json::from_str::>(&cached_users) { return Ok(Json(users)); } } } let users = sqlx::query_as::<_, UserResponse>( "SELECT id, email, name, role::text as role FROM users ORDER BY created_at DESC" ) .fetch_all(&state.db) .await .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, format!("Database error: {}", e)))?; if let Ok(mut con) = client.get_multiplexed_async_connection().await { if let Ok(json_str) = serde_json::to_string(&users) { let _: redis::RedisResult<()> = con.set_ex("users:all", json_str, 60).await; } } Ok(Json(users)) }`); } if (options.dbTarget === "docker" || options.cachingTarget === "docker") { const dc = await resolveDockerCompose(options.projectName, dbPassword, options.dbTarget, options.cachingTarget, options.dbPort, options.redisPort); await Bun.write(join(targetDir, "docker-compose.yml"), dc); } await Bun.write(join(targetDir, ".env"), envContent); } async function generateHonoProject(options: ProjectOptions) { const targetDir = join(process.cwd(), options.projectName); const jwtSecret = generateJwtSecret(); const dbPassword = generateDbPassword(); await Promise.all( PROJECT_FOLDERS.map((folder) => mkdir(join(targetDir, folder), { recursive: true }), ), ); const [ prismaSchema, prismaConfig, tsconfig, envFile, prismaClient, serverSource, errorMiddleware, healthRoutes, userRoutes, userController, userService, authController, authMiddleware, authRoutes, waitForPostgres, dockerCompose, exampleTest ] = await Promise.all([ readTemplate("express/schema.prisma"), readTemplate("express/prisma.config.ts"), readTemplate("express/tsconfig.json"), resolveEnvFile(options.dbTarget, options.projectName, jwtSecret, dbPassword, options.authTarget, options.cachingTarget, options.dbPort, options.redisPort), resolvePrismaClient(options.dbTarget), resolveServerSource(options.extraPackages, "hono", options.authTarget), readTemplate("hono/error.middleware.ts"), readTemplate("hono/health.routes.ts"), readTemplate("hono/user.routes.ts"), options.extraPackages.includes("zod") ? readTemplate("hono/user.controller.zod.ts") : readTemplate("hono/user.controller.default.ts"), resolveUserService(options.cachingTarget), readTemplate(`hono/auth.controller${options.authTarget === 'local' ? '' : '.' + options.authTarget}.ts`), readTemplate(`hono/auth.middleware${options.authTarget === 'local' ? '' : '.' + options.authTarget}.ts`), readTemplate("hono/auth.routes.ts"), options.dbTarget === "docker" ? readTemplate("express/wait-for-postgres.ts") : Promise.resolve(null), options.dbTarget === "docker" || options.cachingTarget === "docker" ? resolveDockerCompose(options.projectName, dbPassword, options.dbTarget, options.cachingTarget, options.dbPort, options.redisPort) : Promise.resolve(null), readTemplate("express/example.test.ts"), ]); const files: Array<[string, string]> = [ ["prisma/schema.prisma", prismaSchema], ["prisma.config.ts", prismaConfig], ["tsconfig.json", tsconfig], [".env", envFile], ["src/lib/prisma.ts", prismaClient], ["src/index.ts", serverSource], ["src/middlewares/error.middleware.ts", errorMiddleware], ["src/middlewares/auth.middleware.ts", authMiddleware], ["src/routes/health.routes.ts", healthRoutes], ["src/routes/user.routes.ts", userRoutes], ["src/routes/auth.routes.ts", authRoutes!], ["src/controllers/user.controller.ts", userController], ["src/controllers/auth.controller.ts", authController!], ["src/services/user.service.ts", userService], ["src/index.test.ts", exampleTest], ]; if (options.dbTarget === "docker" && waitForPostgres) { files.splice(5, 0, ["src/lib/wait-for-postgres.ts", waitForPostgres!]); } if (options.dbTarget === "docker" || options.cachingTarget === "docker") { files.push(["docker-compose.yml", dockerCompose!]); } if (options.cachingTarget === "docker") { files.push(["src/lib/redis.ts", await readTemplate("express/redis.docker.ts")]); } else if (options.cachingTarget === "upstash") { files.push(["src/lib/redis.ts", await readTemplate("express/redis.upstash.ts")]); } await Promise.all([ ...files.map(([path, content]) => writeFile(join(targetDir, path), content)), createPackageJson(options.projectName, options.dbTarget, options.extraPackages, options.cachingTarget, options.authTarget, "hono").then((pkg) => { // Override for Hono pkg.dependencies.hono = "^4.0.0"; pkg.dependencies["@hono/node-server"] = "^1.11.0"; delete pkg.dependencies.cors; delete pkg.dependencies.helmet; delete pkg.devDependencies["@types/cors"]; delete pkg.dependencies.express; delete pkg.devDependencies["@types/express"]; return writeJson(join(targetDir, "package.json"), pkg); }), ]); } async function generateElysiaProject(options: ProjectOptions) { const targetDir = join(process.cwd(), options.projectName); const jwtSecret = generateJwtSecret(); const dbPassword = generateDbPassword(); await Promise.all( PROJECT_FOLDERS.map((folder) => mkdir(join(targetDir, folder), { recursive: true }), ), ); const [ prismaSchema, prismaConfig, tsconfig, envFile, prismaClient, serverSource, errorMiddleware, healthRoutes, userRoutes, userController, userService, authController, authMiddleware, authRoutes, waitForPostgres, dockerCompose, exampleTest ] = await Promise.all([ readTemplate("express/schema.prisma"), readTemplate("express/prisma.config.ts"), readTemplate("express/tsconfig.json"), resolveEnvFile(options.dbTarget, options.projectName, jwtSecret, dbPassword, options.authTarget, options.cachingTarget, options.dbPort, options.redisPort), resolvePrismaClient(options.dbTarget), resolveServerSource(options.extraPackages, "elysia", options.authTarget), readTemplate("elysia/error.middleware.ts"), readTemplate("elysia/health.routes.ts"), readTemplate("elysia/user.routes.ts"), options.extraPackages.includes("zod") ? readTemplate("elysia/user.controller.zod.ts") : readTemplate("elysia/user.controller.default.ts"), resolveUserService(options.cachingTarget), readTemplate(`elysia/auth.controller${options.authTarget === 'local' ? '' : '.' + options.authTarget}.ts`), readTemplate(`elysia/auth.middleware${options.authTarget === 'local' ? '' : '.' + options.authTarget}.ts`), readTemplate("elysia/auth.routes.ts"), options.dbTarget === "docker" ? readTemplate("express/wait-for-postgres.ts") : Promise.resolve(null), options.dbTarget === "docker" || options.cachingTarget === "docker" ? resolveDockerCompose(options.projectName, dbPassword, options.dbTarget, options.cachingTarget, options.dbPort, options.redisPort) : Promise.resolve(null), readTemplate("express/example.test.ts"), ]); const files: Array<[string, string]> = [ ["prisma/schema.prisma", prismaSchema], ["prisma.config.ts", prismaConfig], ["tsconfig.json", tsconfig], [".env", envFile], ["src/lib/prisma.ts", prismaClient], ["src/index.ts", serverSource], ["src/middlewares/error.middleware.ts", errorMiddleware], ["src/middlewares/auth.middleware.ts", authMiddleware], ["src/routes/health.routes.ts", healthRoutes], ["src/routes/user.routes.ts", userRoutes], ["src/routes/auth.routes.ts", authRoutes!], ["src/controllers/user.controller.ts", userController], ["src/controllers/auth.controller.ts", authController!], ["src/services/user.service.ts", userService], ["src/index.test.ts", exampleTest], ]; if (options.dbTarget === "docker" && waitForPostgres) { files.splice(5, 0, ["src/lib/wait-for-postgres.ts", waitForPostgres!]); } if (options.dbTarget === "docker" || options.cachingTarget === "docker") { files.push(["docker-compose.yml", dockerCompose!]); } if (options.cachingTarget === "docker") { files.push(["src/lib/redis.ts", await readTemplate("express/redis.docker.ts")]); } else if (options.cachingTarget === "upstash") { files.push(["src/lib/redis.ts", await readTemplate("express/redis.upstash.ts")]); } await Promise.all([ ...files.map(([path, content]) => writeFile(join(targetDir, path), content)), createPackageJson(options.projectName, options.dbTarget, options.extraPackages, options.cachingTarget, options.authTarget, "elysia").then((pkg) => { // Override for Elysia pkg.dependencies.elysia = "^1.0.0"; if (options.extraPackages.includes("cors")) pkg.dependencies["@elysiajs/cors"] = "^1.0.2"; if (options.extraPackages.includes("helmet")) pkg.dependencies["elysia-helmet"] = "^3.1.0"; delete pkg.dependencies.cors; delete pkg.dependencies.helmet; delete pkg.devDependencies["@types/cors"]; delete pkg.dependencies.express; delete pkg.devDependencies["@types/express"]; return writeJson(join(targetDir, "package.json"), pkg); }), ]); } export async function generateProject(options: ProjectOptions) { if (options.framework === "express") { await generateExpressProject(options); } else if (options.framework === "laravel") { await generateLaravelProject(options); } else if (options.framework === "nextjs") { await generateNextJsProject(options); } else if (options.framework === "react") { await generateReactProject(options); } else if (options.framework === "vue") { await generateVueProject(options); } else if (options.framework === "python") { await generatePythonProject(options); } else if (options.framework === "go") { await generateGoProject(options); } else if (options.framework === "rust") { await generateRustProject(options); } else if (options.framework === "hono") { await generateHonoProject(options); } else if (options.framework === "elysia") { await generateElysiaProject(options); } else if (options.framework === "monorepo") { const rootName = options.projectName; const targetDir = join(process.cwd(), rootName); // Generate backend options.framework = options.backendFramework!; options.projectName = `${rootName}/backend`; await generateProject(options); // Generate frontend options.framework = options.frontendFramework!; options.projectName = `${rootName}/frontend`; await generateProject(options); // Generate root orchestration let backendCmd = "bun dev"; if (options.backendFramework === "laravel") backendCmd = "php artisan serve"; if (options.backendFramework === "python") backendCmd = process.platform === "win32" ? "venv\\\\Scripts\\\\uvicorn app.main:app --reload" : "venv/bin/uvicorn app.main:app --reload"; if (options.backendFramework === "go") backendCmd = "go run cmd/api/main.go"; if (options.backendFramework === "rust") backendCmd = "cargo run"; const includeBackendWorkspace = ["express", "hono", "elysia", "laravel"].includes(options.backendFramework!); const hasPrismaBackend = ["express", "hono", "elysia"].includes(options.backendFramework!); const rootPkg = { name: rootName, private: true, workspaces: includeBackendWorkspace ? ["backend", "frontend"] : ["frontend"], scripts: { dev: `bunx concurrently "cd backend && ${backendCmd}" "cd frontend && bun dev"`, ...(hasPrismaBackend ? { "db:generate": "cd backend && bun run db:generate", "db:push": "cd backend && bun run db:push", "db:studio": "cd backend && bun run db:studio", } : options.backendFramework === "laravel" ? { "db:migrate": "cd backend && php artisan migrate" } : {}), }, // `bunx concurrently` resolves this local dependency instead of fetching // an undeclared package the first time `bun run dev` is executed. devDependencies: { concurrently: packageVersions.devDependencies.concurrently, }, }; await Bun.write(join(targetDir, "package.json"), JSON.stringify(rootPkg, null, 2)); // Restore project name and framework options.projectName = rootName; options.framework = "monorepo"; } }