create-bw-app 0.3.0

package/README.md

@@ -0,0 +1,34 @@
+# create-bw-app
+
+Create a new BrightWeb app from either the platform or site starter.
+
+## Local workspace usage
+
+From the BrightWeb platform repo root:
+
+```bash
+pnpm create:client
+pnpm create:client -- --template site
+```
+
+## Future published usage
+
+Once this package is published to npm:
+
+```bash
+pnpm dlx create-bw-app
+npm create bw-app@latest
+```
+
+## Template behavior
+
+- prompts for app type: `platform` or `site`
+- prompts for project name
+- prompts for optional modules with a checkbox list when using the platform template
+- prompts to install dependencies immediately
+- copies a clean Next.js starter template
+- platform apps include BrightWeb auth, shell, and optional business modules
+- site apps include Next.js, Tailwind CSS, and local shadcn-style component primitives
+- writes `package.json`, `next.config.ts`, `.gitignore`, and `README.md` for both templates
+- platform apps also write `.env.example` and `.env.local`
+- supports repo-local `workspace:*` wiring and future published dependency wiring

package/bin/create-bw-app.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { runCreateBwAppCli } from "../src/cli.mjs";
+
+runCreateBwAppCli(process.argv.slice(2)).catch((error) => {
+  const message = error instanceof Error ? error.message : "Unknown error";
+  console.error(`\ncreate-bw-app failed: ${message}`);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "create-bw-app",
+  "private": false,
+  "version": "0.3.0",
+  "type": "module",
+  "bin": "bin/create-bw-app.mjs",
+  "files": [
+    "bin",
+    "src",
+    "template",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BWLeoRibeiro/brightweb-platform.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0"
+  }
+}

package/src/cli.mjs

@@ -0,0 +1,78 @@
+import { HELP_TEXT } from "./constants.mjs";
+import { createBrightwebClientApp } from "./generator.mjs";
+
+function toCamelCase(flagName) {
+  return flagName.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+
+function parseArgv(argv) {
+  const options = {};
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+
+    if (token === "--") {
+      continue;
+    }
+
+    if (!token.startsWith("--")) continue;
+    if (token === "--help") {
+      options.help = true;
+      continue;
+    }
+
+    if (token === "--install") {
+      options.install = true;
+      continue;
+    }
+
+    if (token === "--no-install") {
+      options.install = false;
+      continue;
+    }
+
+    if (token === "--yes") {
+      options.yes = true;
+      continue;
+    }
+
+    if (token === "--dry-run") {
+      options.dryRun = true;
+      continue;
+    }
+
+    const [rawKey, inlineValue] = token.slice(2).split("=", 2);
+    const key = toCamelCase(rawKey);
+    const nextValue = inlineValue ?? argv[index + 1];
+
+    if (inlineValue == null) {
+      index += 1;
+    }
+
+    options[key] = nextValue;
+  }
+
+  return options;
+}
+
+export async function runCreateBwAppCli(argv = process.argv.slice(2), runtimeOptions = {}) {
+  const argvOptions = parseArgv(argv);
+
+  if (argvOptions.help) {
+    process.stdout.write(`${HELP_TEXT}\n`);
+    return;
+  }
+
+  try {
+    await createBrightwebClientApp(argvOptions, runtimeOptions);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    if (message.includes("User force closed the prompt with SIGINT")) {
+      console.error("\nCancelled. Use Ctrl+C to exit an interactive prompt.\n");
+      process.exitCode = 1;
+      return;
+    }
+    console.error(`\n${runtimeOptions.failurePrefix || "create-bw-app failed"}: ${message}`);
+    process.exitCode = 1;
+  }
+}

package/src/constants.mjs

@@ -0,0 +1,114 @@
+export const CLI_PACKAGE_NAME = "create-bw-app";
+export const CLI_DISPLAY_NAME = "create-bw-app";
+
+export const TEMPLATE_OPTIONS = [
+  {
+    key: "platform",
+    label: "Platform app",
+    description: "Authenticated BrightWeb app shell with optional business modules.",
+  },
+  {
+    key: "site",
+    label: "Site",
+    description: "Standalone Next.js + Tailwind site starter with a local UI layer.",
+  },
+];
+
+export const SELECTABLE_MODULES = [
+  {
+    key: "crm",
+    label: "CRM",
+    packageName: "@brightweblabs/module-crm",
+    templateFolder: "crm",
+    envKey: "NEXT_PUBLIC_ENABLE_CRM",
+  },
+  {
+    key: "projects",
+    label: "Projects",
+    packageName: "@brightweblabs/module-projects",
+    templateFolder: "projects",
+    envKey: "NEXT_PUBLIC_ENABLE_PROJECTS",
+  },
+  {
+    key: "admin",
+    label: "Admin",
+    packageName: "@brightweblabs/module-admin",
+    templateFolder: "admin",
+    envKey: "NEXT_PUBLIC_ENABLE_ADMIN",
+  },
+];
+
+export const CORE_PACKAGES = [
+  "@brightweblabs/app-shell",
+  "@brightweblabs/core-auth",
+  "@brightweblabs/infra",
+  "@brightweblabs/ui",
+];
+
+export const APP_DEPENDENCY_DEFAULTS = {
+  "@brightweblabs/app-shell": "^0.1.1",
+  "@brightweblabs/core-auth": "^0.1.1",
+  "@brightweblabs/infra": "^0.1.0",
+  "@brightweblabs/module-admin": "^0.1.1",
+  "@brightweblabs/module-crm": "^0.1.1",
+  "@brightweblabs/module-projects": "^0.1.1",
+  "@brightweblabs/ui": "^0.1.0",
+  "lucide-react": "^0.562.0",
+  "next": "16.1.1",
+  "react": "19.2.3",
+  "react-dom": "19.2.3",
+};
+
+export const SITE_DEPENDENCY_DEFAULTS = {
+  "class-variance-authority": "^0.7.1",
+  "clsx": "^2.1.1",
+  "lucide-react": "^0.562.0",
+  "next": "16.1.1",
+  "react": "19.2.3",
+  "react-dom": "19.2.3",
+  "tailwind-merge": "^3.4.0",
+};
+
+export const APP_DEV_DEPENDENCY_DEFAULTS = {
+  "@types/node": "^20",
+  "@types/react": "^19",
+  "@types/react-dom": "^19",
+  "typescript": "^5",
+};
+
+export const SITE_DEV_DEPENDENCY_DEFAULTS = {
+  "@tailwindcss/postcss": "^4.0.0",
+  "@types/node": "^20",
+  "@types/react": "^19",
+  "@types/react-dom": "^19",
+  "postcss": "^8.4.31",
+  "tailwindcss": "^4.0.0",
+  "typescript": "^5",
+};
+
+export const DEFAULTS = {
+  productNameSuffix: "Platform",
+  tagline: "A configurable Brightweb starter app for new client instances.",
+  contactEmail: "hello@example.com",
+  supportEmail: "support@example.com",
+  primaryHex: "#1f7a45",
+};
+
+export const HELP_TEXT = `
+Usage:
+  create-bw-app [options]
+
+Options:
+  --template <platform|site>    Scaffold a platform app or a standalone site
+  --name, --slug <name>          Project name and default directory name
+  --modules <list>               Comma-separated modules: crm,projects,admin
+  --output-dir <path>            Parent folder for the generated app
+  --target-dir <path>            Exact output directory, bypassing slug folder creation
+  --workspace-root <path>        BrightWeb workspace root for local mode
+  --dependency-mode <mode>       "workspace" or "published"
+  --install                      Install dependencies after scaffolding
+  --no-install                   Skip dependency installation
+  --yes                          Accept defaults for any missing optional prompt
+  --dry-run                      Print planned actions without writing files
+  --help                         Show this help message
+`.trim();