create-lovstudio-app 1.0.0

package/README.md

@@ -0,0 +1,61 @@
+# create-lovstudio-app
+
+Create a new Lovstudio Next.js project with one command.
+
+## Usage
+
+```bash
+npx create-lovstudio-app my-app
+```
+
+Or with your preferred package manager:
+
+```bash
+pnpm create lovstudio-app my-app
+yarn create lovstudio-app my-app
+bun create lovstudio-app my-app
+```
+
+## Features
+
+The CLI creates a project based on the [Lovstudio Next.js template](https://github.com/lovstudio/lovweb) with:
+
+- ⚡️ **Next.js 15** with App Router
+- 🔒 **Supabase Auth** with cookie-based sessions
+- 🗄️ **DrizzleORM** with PostgreSQL
+- 🎨 **Tailwind CSS v4** + shadcn/ui
+- 🌐 **i18n** with next-intl (Chinese/English)
+- 📊 **Monitoring** with Sentry + PostHog
+- 🛡️ **Security** with Arcjet
+
+## Options
+
+```bash
+create-lovstudio-app [project-name] [options]
+
+Options:
+  --skip-install    Skip dependency installation
+  --use-npm         Use npm as package manager
+  --use-pnpm        Use pnpm as package manager
+  --use-yarn        Use yarn as package manager
+  --use-bun         Use bun as package manager
+  -h, --help        Display help
+  -v, --version     Display version
+```
+
+## Interactive Mode
+
+When you run `create-lovstudio-app`, it will prompt you to:
+
+1. Enter project name
+2. Select features to include:
+   - Supabase Auth (default: yes)
+   - i18n support (default: yes)
+   - Storybook (default: no)
+   - Monitoring (default: yes)
+3. Choose package manager
+4. Initialize git repository
+
+## License
+
+MIT

package/dist/index.mjs

@@ -0,0 +1,384 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { cac } from "cac";
+
+// src/create.ts
+import { execSync as execSync2 } from "child_process";
+import fs2 from "fs";
+import path2 from "path";
+import ora from "ora";
+import pc3 from "picocolors";
+
+// src/prompts.ts
+import prompts from "prompts";
+import pc from "picocolors";
+
+// src/utils/package-manager.ts
+import { execSync } from "child_process";
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  if (userAgent.startsWith("pnpm"))
+    return "pnpm";
+  if (userAgent.startsWith("yarn"))
+    return "yarn";
+  if (userAgent.startsWith("bun"))
+    return "bun";
+  return "npm";
+}
+function isPackageManagerInstalled(pm) {
+  try {
+    execSync(`${pm} --version`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getInstallCommand(pm) {
+  switch (pm) {
+    case "pnpm":
+      return "pnpm install";
+    case "yarn":
+      return "yarn";
+    case "bun":
+      return "bun install";
+    default:
+      return "npm install";
+  }
+}
+
+// src/prompts.ts
+async function promptProjectConfig(defaultName) {
+  const detectedPm = detectPackageManager();
+  const response = await prompts(
+    [
+      {
+        type: "text",
+        name: "projectName",
+        message: "Project name:",
+        initial: defaultName || "my-lovstudio-app",
+        validate: (value) => {
+          if (!value)
+            return "Project name is required";
+          if (!/^[a-z0-9-_]+$/i.test(value))
+            return "Project name can only contain letters, numbers, hyphens and underscores";
+          return true;
+        }
+      },
+      {
+        type: "multiselect",
+        name: "features",
+        message: "Select features:",
+        instructions: pc.dim("(space to select, enter to confirm)"),
+        choices: [
+          { title: "Supabase Auth", value: "supabase", selected: true },
+          { title: "i18n (Chinese/English)", value: "i18n", selected: true },
+          { title: "Storybook", value: "storybook", selected: false },
+          { title: "Monitoring (Sentry + PostHog)", value: "monitoring", selected: true }
+        ]
+      },
+      {
+        type: "select",
+        name: "packageManager",
+        message: "Package manager:",
+        choices: [
+          { title: `pnpm ${detectedPm === "pnpm" ? pc.dim("(detected)") : pc.dim("(recommended)")}`, value: "pnpm" },
+          { title: `npm ${detectedPm === "npm" ? pc.dim("(detected)") : ""}`, value: "npm" },
+          { title: `yarn ${detectedPm === "yarn" ? pc.dim("(detected)") : ""}`, value: "yarn" },
+          { title: `bun ${detectedPm === "bun" ? pc.dim("(detected)") : ""}`, value: "bun" }
+        ],
+        initial: detectedPm === "pnpm" ? 0 : detectedPm === "npm" ? 1 : detectedPm === "yarn" ? 2 : 3
+      },
+      {
+        type: "confirm",
+        name: "initGit",
+        message: "Initialize a git repository?",
+        initial: true
+      }
+    ],
+    {
+      onCancel: () => {
+        console.log(pc.red("\nOperation cancelled"));
+        process.exit(0);
+      }
+    }
+  );
+  if (!isPackageManagerInstalled(response.packageManager)) {
+    console.log(pc.yellow(`
+\u26A0 ${response.packageManager} is not installed. Falling back to npm.`));
+    response.packageManager = "npm";
+  }
+  const featureSet = new Set(response.features || []);
+  return {
+    projectName: response.projectName,
+    features: {
+      supabase: featureSet.has("supabase"),
+      i18n: featureSet.has("i18n"),
+      storybook: featureSet.has("storybook"),
+      monitoring: featureSet.has("monitoring")
+    },
+    packageManager: response.packageManager,
+    initGit: response.initGit
+  };
+}
+
+// src/template.ts
+import { downloadTemplate } from "giget";
+var TEMPLATE_REPO = "github:lovstudio/lovweb";
+async function download(dest, _config) {
+  await downloadTemplate(TEMPLATE_REPO, {
+    dir: dest,
+    force: true
+    // Can specify ref: 'v1.0.0' to lock version
+  });
+}
+
+// src/postprocess.ts
+import fs from "fs";
+import path from "path";
+var ALWAYS_REMOVE = [
+  "cli",
+  ".changeset",
+  ".github",
+  "CHANGELOG.md",
+  ".coderabbit.yaml",
+  "crowdin.yml",
+  "codecov.yml",
+  "checkly.config.ts",
+  "unlighthouse.config.ts",
+  ".claude",
+  "CLAUDE.md",
+  "AGENTS.md"
+];
+var STORYBOOK_FILES = [
+  ".storybook"
+];
+var STORYBOOK_PATTERNS = [".stories.tsx", ".stories.ts"];
+var I18N_FILES = [
+  "src/locales",
+  "crowdin.yml"
+];
+var MONITORING_FILES = [
+  "src/instrumentation.ts",
+  "src/instrumentation-client.ts",
+  "sentry.client.config.ts",
+  "sentry.server.config.ts",
+  "sentry.edge.config.ts"
+];
+async function processTemplate(projectPath, config) {
+  for (const file of ALWAYS_REMOVE) {
+    await removeIfExists(path.join(projectPath, file));
+  }
+  if (!config.features.storybook) {
+    for (const file of STORYBOOK_FILES) {
+      await removeIfExists(path.join(projectPath, file));
+    }
+    await removeMatchingFiles(projectPath, STORYBOOK_PATTERNS);
+  }
+  if (!config.features.i18n) {
+    for (const file of I18N_FILES) {
+      await removeIfExists(path.join(projectPath, file));
+    }
+  }
+  if (!config.features.monitoring) {
+    for (const file of MONITORING_FILES) {
+      await removeIfExists(path.join(projectPath, file));
+    }
+  }
+  await updatePackageJson(projectPath, config);
+  await ensureEnvExample(projectPath, config);
+}
+async function removeIfExists(filePath) {
+  try {
+    const stat = await fs.promises.stat(filePath);
+    if (stat.isDirectory()) {
+      await fs.promises.rm(filePath, { recursive: true, force: true });
+    } else {
+      await fs.promises.unlink(filePath);
+    }
+  } catch {
+  }
+}
+async function removeMatchingFiles(dir, patterns) {
+  const entries = await fs.promises.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git")
+        continue;
+      await removeMatchingFiles(fullPath, patterns);
+    } else if (patterns.some((pattern) => entry.name.endsWith(pattern))) {
+      await fs.promises.unlink(fullPath);
+    }
+  }
+}
+async function updatePackageJson(projectPath, config) {
+  const pkgPath = path.join(projectPath, "package.json");
+  const pkg = JSON.parse(await fs.promises.readFile(pkgPath, "utf-8"));
+  pkg.name = config.projectName;
+  pkg.version = "0.1.0";
+  pkg.private = true;
+  delete pkg.repository;
+  delete pkg.bugs;
+  delete pkg.homepage;
+  if (!config.features.storybook) {
+    delete pkg.scripts?.storybook;
+    delete pkg.scripts?.["build-storybook"];
+    delete pkg.devDependencies?.["@chromatic-com/storybook"];
+    delete pkg.devDependencies?.["@storybook/addon-essentials"];
+    delete pkg.devDependencies?.["@storybook/addon-interactions"];
+    delete pkg.devDependencies?.["@storybook/addon-onboarding"];
+    delete pkg.devDependencies?.["@storybook/blocks"];
+    delete pkg.devDependencies?.["@storybook/nextjs"];
+    delete pkg.devDependencies?.["@storybook/react"];
+    delete pkg.devDependencies?.["@storybook/test"];
+    delete pkg.devDependencies?.storybook;
+  }
+  if (!config.features.monitoring) {
+    delete pkg.dependencies?.["@sentry/nextjs"];
+    delete pkg.dependencies?.["posthog-js"];
+    delete pkg.dependencies?.["@logtape/logtape"];
+    delete pkg.dependencies?.["@logtape/otel"];
+    delete pkg.dependencies?.["@better-stack/browser-sdk"];
+  }
+  if (config.packageManager !== "pnpm") {
+    delete pkg.packageManager;
+  }
+  await fs.promises.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+async function ensureEnvExample(projectPath, config) {
+  const envExamplePath = path.join(projectPath, ".env.example");
+  let envContent = `# Database
+DATABASE_URL=
+
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
+`;
+  if (config.features.monitoring) {
+    envContent += `
+# Monitoring (optional)
+SENTRY_DSN=
+NEXT_PUBLIC_POSTHOG_KEY=
+NEXT_PUBLIC_POSTHOG_HOST=
+BETTER_STACK_SOURCE_TOKEN=
+`;
+  }
+  envContent += `
+# Security (optional)
+ARCJET_KEY=
+`;
+  await fs.promises.writeFile(envExamplePath, envContent);
+}
+
+// src/utils/logger.ts
+import pc2 from "picocolors";
+var logger = {
+  info: (msg) => console.log(pc2.cyan(msg)),
+  success: (msg) => console.log(pc2.green(`\u2714 ${msg}`)),
+  warn: (msg) => console.log(pc2.yellow(`\u26A0 ${msg}`)),
+  error: (msg) => console.log(pc2.red(`\u2716 ${msg}`)),
+  log: (msg) => console.log(msg),
+  blank: () => console.log()
+};
+function banner() {
+  console.log();
+  console.log(pc2.cyan("\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E"));
+  console.log(pc2.cyan("\u2502") + pc2.bold("  \u{1F3E0} Create Lovstudio App               ") + pc2.cyan("\u2502"));
+  console.log(pc2.cyan("\u2502") + pc2.dim("     Next.js 15 + TypeScript            ") + pc2.cyan("\u2502"));
+  console.log(pc2.cyan("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"));
+  console.log();
+}
+function printNextSteps(projectName, packageManager) {
+  const pmRun = packageManager === "npm" ? "npm run" : packageManager;
+  console.log();
+  console.log(pc2.green("\u{1F389} Success!") + ` Created ${pc2.bold(projectName)}`);
+  console.log();
+  console.log(pc2.dim("Next steps:"));
+  console.log();
+  console.log(`  ${pc2.cyan("cd")} ${projectName}`);
+  console.log(`  ${pc2.cyan("cp")} .env.example .env.local`);
+  console.log(`  ${pc2.cyan(pmRun)} dev`);
+  console.log();
+  console.log(pc2.dim("\u{1F4DA} Documentation: https://github.com/lovstudio/lovweb"));
+  console.log();
+}
+
+// src/create.ts
+async function create(projectName, options) {
+  banner();
+  const config = await promptProjectConfig(projectName);
+  if (!config)
+    return;
+  if (options?.useNpm)
+    config.packageManager = "npm";
+  if (options?.usePnpm)
+    config.packageManager = "pnpm";
+  if (options?.useYarn)
+    config.packageManager = "yarn";
+  if (options?.useBun)
+    config.packageManager = "bun";
+  const projectPath = path2.resolve(process.cwd(), config.projectName);
+  if (fs2.existsSync(projectPath)) {
+    const files = fs2.readdirSync(projectPath);
+    if (files.length > 0) {
+      logger.error(`Directory ${pc3.bold(config.projectName)} is not empty.`);
+      process.exit(1);
+    }
+  }
+  console.log();
+  const downloadSpinner = ora("Downloading template...").start();
+  try {
+    await download(projectPath, config);
+    downloadSpinner.succeed("Downloaded template");
+  } catch (error) {
+    downloadSpinner.fail("Failed to download template");
+    logger.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+  const processSpinner = ora("Processing template...").start();
+  try {
+    await processTemplate(projectPath, config);
+    processSpinner.succeed("Processed template");
+  } catch (error) {
+    processSpinner.fail("Failed to process template");
+    logger.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+  if (!options?.skipInstall) {
+    const installSpinner = ora(`Installing dependencies with ${config.packageManager}...`).start();
+    try {
+      const installCmd = getInstallCommand(config.packageManager);
+      execSync2(installCmd, {
+        cwd: projectPath,
+        stdio: "pipe"
+      });
+      installSpinner.succeed("Installed dependencies");
+    } catch (error) {
+      installSpinner.fail("Failed to install dependencies");
+      logger.warn("You can try installing manually later.");
+    }
+  }
+  if (config.initGit) {
+    const gitSpinner = ora("Initializing git repository...").start();
+    try {
+      execSync2("git init", { cwd: projectPath, stdio: "pipe" });
+      execSync2("git add -A", { cwd: projectPath, stdio: "pipe" });
+      execSync2('git commit -m "Initial commit from create-lovstudio-app"', {
+        cwd: projectPath,
+        stdio: "pipe"
+      });
+      gitSpinner.succeed("Initialized git repository");
+    } catch {
+      gitSpinner.fail("Failed to initialize git repository");
+    }
+  }
+  printNextSteps(config.projectName, config.packageManager);
+}
+
+// src/index.ts
+var cli = cac("create-lovstudio-app");
+cli.command("[project-name]", "Create a new Lovstudio Next.js project").option("--skip-install", "Skip dependency installation").option("--use-npm", "Use npm as package manager").option("--use-pnpm", "Use pnpm as package manager").option("--use-yarn", "Use yarn as package manager").option("--use-bun", "Use bun as package manager").action(create);
+cli.help();
+cli.version("1.0.0");
+cli.parse();

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "create-lovstudio-app",
+  "version": "1.0.0",
+  "description": "Create a new Lovstudio Next.js project",
+  "type": "module",
+  "bin": {
+    "create-lovstudio-app": "./dist/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "release": "pnpm build && npm publish",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "create",
+    "lovstudio",
+    "nextjs",
+    "template",
+    "boilerplate",
+    "supabase",
+    "typescript"
+  ],
+  "author": "Lovstudio",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lovstudio/lovweb.git",
+    "directory": "cli"
+  },
+  "bugs": {
+    "url": "https://github.com/lovstudio/lovweb/issues"
+  },
+  "homepage": "https://github.com/lovstudio/lovweb#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "cac": "^6.7.14",
+    "giget": "^1.2.3",
+    "ora": "^8.1.1",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  }
+}