create-z3 0.0.13 → 0.0.15

package/dist/index.js

@@ -6,7 +6,7 @@ import { select, input, checkbox, confirm, Separator } from "@inquirer/prompts";
 import chalk2 from "chalk";
 import { readFileSync } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname as dirname2, join as join3 } from "path";
+import { dirname as dirname2, join as join4 } from "path";
 
 // src/utils/validation.ts
 import validateNpmPackageName from "validate-npm-package-name";
@@ -2473,11 +2473,137 @@ var TanStackInstaller = class extends FrameworkInstaller {
   }
 };
 
+// src/installers/nextjs.ts
+import { join as join3 } from "path";
+var NextJSInstaller = class extends FrameworkInstaller {
+  /**
+   * Framework identifier for Next.js
+   */
+  get frameworkName() {
+    return "nextjs";
+  }
+  /**
+   * Update OAuth configuration in Convex auth file
+   * Target file: convex/auth/index.ts (SAME as TanStack)
+   * Placeholders: // {{EMAIL_PASSWORD_AUTH}} and // {{OAUTH_PROVIDERS}}
+   *
+   * @param selectedProviders - Array of provider IDs to configure
+   * @param emailPasswordEnabled - Whether email/password authentication is enabled
+   */
+  async updateOAuthConfig(selectedProviders, emailPasswordEnabled) {
+    const authFilePath = join3(this.targetPath, "convex/auth/index.ts");
+    const authProvidersBlock = generateAuthProvidersBlock(
+      selectedProviders,
+      emailPasswordEnabled
+    );
+    await replacePlaceholder(
+      authFilePath,
+      "// {{OAUTH_PROVIDERS}}",
+      authProvidersBlock
+    );
+    await replacePlaceholder(
+      authFilePath,
+      "// {{EMAIL_PASSWORD_AUTH}}",
+      "",
+      { graceful: true }
+    );
+  }
+  /**
+   * Update OAuth UI configuration in auth client file
+   * Target file: src/auth/client.tsx (DIFFERENT from TanStack: src/providers.tsx)
+   * Placeholder: // {{OAUTH_UI_PROVIDERS}}
+   *
+   * @param selectedProviders - Array of provider IDs to configure
+   */
+  async updateOAuthUIConfig(selectedProviders) {
+    const providersFilePath = join3(this.targetPath, "src/auth/client.tsx");
+    const uiConfigBlock = generateOAuthUIProvidersBlock(selectedProviders);
+    await replacePlaceholder(
+      providersFilePath,
+      "// {{OAUTH_UI_PROVIDERS}}",
+      uiConfigBlock
+    );
+  }
+  /**
+   * Update .env.example with OAuth environment variables
+   * Target file: .env.example (SAME as TanStack)
+   * Placeholder: # {{ENV_OAUTH_VARS}}
+   * Applies NEXT_PUBLIC_ prefix for client-side variables (DIFFERENT parameter from TanStack)
+   *
+   * @param selectedProviders - Array of provider IDs to configure
+   */
+  async updateEnvExample(selectedProviders) {
+    const envFilePath = join3(this.targetPath, ".env.example");
+    const envVarsBlock = generateEnvVarsBlock(selectedProviders, "nextjs");
+    await replacePlaceholder(
+      envFilePath,
+      "# {{ENV_OAUTH_VARS}}",
+      envVarsBlock
+    );
+  }
+  /**
+   * Update README with OAuth provider setup guides
+   * Target file: README.md (SAME as TanStack)
+   * Placeholder: <!-- {{OAUTH_SETUP_GUIDE}} -->
+   * Handles missing placeholder gracefully with warning
+   *
+   * @param selectedProviders - Array of provider IDs to configure
+   */
+  async updateReadme(selectedProviders) {
+    const readmeFilePath = join3(this.targetPath, "README.md");
+    const readmeSection = generateReadmeSection(selectedProviders);
+    await replacePlaceholder(
+      readmeFilePath,
+      "<!-- {{OAUTH_SETUP_GUIDE}} -->",
+      readmeSection,
+      { graceful: true }
+    );
+  }
+  /**
+   * Apply TweakCN theme to global CSS file
+   * Target file: src/app/(frontend)/globals.css (DIFFERENT from TanStack: src/styles/globals.css)
+   * Placeholder: CSS comment with TWEAKCN_THEME variable
+   *
+   * @param themeContent - CSS content to apply
+   */
+  async applyTweakCNTheme(themeContent) {
+    const cssFilePath = join3(this.targetPath, "src/app/(frontend)/globals.css");
+    await replacePlaceholder(
+      cssFilePath,
+      "/* {{TWEAKCN_THEME}} */",
+      themeContent
+    );
+  }
+  /**
+   * Update env.mjs with OAuth provider environment variables
+   * Target file: src/env.mjs (DIFFERENT from TanStack: src/env.ts - Next.js uses env.mjs)
+   * Placeholders: // {{OAUTH_ENV_SERVER_SCHEMA}} and // {{OAUTH_ENV_RUNTIME_MAPPING}}
+   * Adds zod schema validation and runtime mappings for OAuth credentials
+   *
+   * @param selectedProviders - Array of provider IDs to configure
+   */
+  async updateEnvTs(selectedProviders) {
+    const envFilePath = join3(this.targetPath, "src/env.mjs");
+    const serverSchema = generateEnvTsServerSchema(selectedProviders);
+    await replacePlaceholder(
+      envFilePath,
+      "// {{OAUTH_ENV_SERVER_SCHEMA}}",
+      serverSchema
+    );
+    const runtimeMapping = generateEnvTsRuntimeMapping(selectedProviders);
+    await replacePlaceholder(
+      envFilePath,
+      "// {{OAUTH_ENV_RUNTIME_MAPPING}}",
+      runtimeMapping
+    );
+  }
+};
+
 // src/index.ts
 var __filename = fileURLToPath2(import.meta.url);
 var __dirname = dirname2(__filename);
 var packageJson = JSON.parse(
-  readFileSync(join3(__dirname, "../package.json"), "utf-8")
+  readFileSync(join4(__dirname, "../package.json"), "utf-8")
 );
 var program = new Command();
 async function promptOAuthProviders() {
@@ -2633,7 +2759,7 @@ program.name("create-z3").version(packageJson.version).description("CLI for scaf
     if (framework === "tanstack") {
       installer = new TanStackInstaller(createdPath, projectName);
     } else {
-      throw new Error("Next.js installer not yet implemented. Please use TanStack Start.");
+      installer = new NextJSInstaller(createdPath, projectName);
     }
     try {
       await installer.initProject(projectOptions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-z3",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "type": "module",
   "description": "CLI for scaffolding Z3 Stack applications (TanStack/Next.js + Convex + Better Auth)",
   "bin": {

package/templates/nextjs/.env.example

@@ -0,0 +1,18 @@
+# Since the ".env" file is gitignored, you can use the ".env.example" file to
+# build a new ".env" file when you clone the repo. Keep this file up-to-date
+# when you add new variables to `.env`.
+
+# This file will be committed to version control, so make sure not to have any
+# secrets in it. If you are cloning this repo, create a copy of this file named
+# ".env" and populate it with your secrets.
+
+# When adding additional environment variables, the schema in "/src/env.js"
+# should be updated accordingly.
+
+NEXT_PUBLIC_CONVEX_URL=""
+NEXT_PUBLIC_CONVEX_SITE_URL=""
+
+NEXT_PUBLIC_SITE_URL="http://localhost:3000"
+BETTER_AUTH_SECRET=""
+
+# {{ENV_OAUTH_VARS}}