create-bw-app 0.7.0 → 0.8.0

package/README.md

@@ -1,22 +1,26 @@
 # create-bw-app
 
-Create a new BrightWeb app from either the platform or site starter.
+Scaffold a new BrightWeb app from either the `platform` or `site` starter.
 
-## Local workspace usage
+## Workspace usage
 
 From the BrightWeb platform repo root:
 
 ```bash
 pnpm create:client
+pnpm create:client -- --help
 pnpm create:client -- --template site
 ```
 
-## Future published usage
+The workspace wrapper delegates to this package with `workspace:*` dependency wiring and BrightWeb-specific output rules.
+
+## Published usage
 
 Once this package is published to npm:
 
 ```bash
 pnpm dlx create-bw-app
+pnpm dlx create-bw-app --template site
 npm create bw-app@latest
 ```
 
@@ -24,11 +28,30 @@ npm create bw-app@latest
 
 - 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 for optional platform modules: `admin`, `crm`, and `projects`
 - 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
+- copies a clean Next.js App Router starter template
+- platform apps include BrightWeb auth, shell wiring, and optional module starter surfaces
+- site apps include Next.js, Tailwind CSS v4, and local component primitives
 - writes `package.json`, `next.config.ts`, `.gitignore`, and `README.md` for both templates
-- platform apps also write `.env.example` and `.env.local`
+- platform apps also write `.env.example`, generated config files, and module feature flags
 - supports repo-local `workspace:*` wiring and future published dependency wiring
+
+## Workspace mode extras
+
+When this package runs in BrightWeb workspace mode, it can:
+
+- write the new app under `apps/<slug>`
+- keep internal dependencies on `workspace:*`
+- create `supabase/clients/<slug>/stack.json`
+- create a client-only migrations folder so database planning stays aligned with scaffolded modules
+
+Platform mode always resolves to the `Core + Admin` database baseline. Selecting `admin` affects the Admin starter UI and package wiring, not whether the Admin database layer exists.
+
+## Related references
+
+- `packages/create-bw-app/src/generator.mjs`
+- `packages/create-bw-app/src/constants.mjs`
+- `packages/create-bw-app/template/base`
+- `packages/create-bw-app/template/site/base`
+- `packages/create-bw-app/template/modules`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-bw-app",
   "private": false,
-  "version": "0.7.0",
+  "version": "0.8.0",
   "type": "module",
   "bin": "bin/create-bw-app.mjs",
   "files": [

package/src/generator.mjs

@@ -189,7 +189,7 @@ function createDbInstallPlan({ selectedModules, workspaceMode, registry }) {
   const notes = [];
 
   if (!selectedModules.includes("admin") && resolvedOrder.includes("admin")) {
-    notes.push("Admin governance stays enabled for platform auth/RBAC even if the admin UI module is not selected.");
+    notes.push("Platform always resolves to the Core + Admin database baseline; selecting Admin only controls whether the Admin starter UI and package wiring are scaffolded.");
   }
 
   for (const moduleKey of resolvedOrder) {
@@ -363,12 +363,12 @@ function createPlatformReadme({
 
   const localSteps = workspaceMode
     ? [
-        "1. Review `.env.example`, then fill `.env.local` with real service credentials.",
+        "1. Review `.env.example`, then copy it to `.env.local` and fill in real service credentials.",
         "2. Run `pnpm install` from the BrightWeb workspace root.",
         `3. Run \`pnpm --filter ${slug} dev\`.`,
       ]
     : [
-        "1. Review `.env.example`, then fill `.env.local` with real service credentials.",
+        "1. Review `.env.example`, then copy it to `.env.local` and fill in real service credentials.",
         `2. Run \`${packageManager} install\`.`,
         `3. Run \`${packageManager} dev\`.`,
       ];
@@ -716,7 +716,7 @@ async function writeWorkspaceClientStack(workspaceRoot, slug, selectedModules) {
           "Generated by create-bw-app in workspace mode.",
           `Selected app modules: ${dbInstallPlan.selectedLabels.length > 0 ? dbInstallPlan.selectedLabels.join(", ") : "none"}.`,
           `Resolved database stack: ${enabledModules.map((moduleKey) => getModuleLabel(moduleKey)).join(" -> ")}.`,
-          "Admin governance stays enabled for platform auth/RBAC even if the admin UI module is not selected.",
+          "Platform always resolves to the Core + Admin database baseline; selecting Admin only controls whether the Admin starter UI and package wiring are scaffolded.",
           "The database install order is resolved from supabase/module-registry.json.",
         ],
       },
@@ -904,7 +904,6 @@ async function scaffoldPlatformProject({
   const envFileContent = createEnvFileContent({ slug: answers.slug, brandValues, moduleFlags });
 
   await fs.writeFile(path.join(targetDir, ".env.example"), envFileContent);
-  await fs.writeFile(path.join(targetDir, ".env.local"), envFileContent);
   await fs.writeFile(path.join(targetDir, ".gitignore"), createGitignore());
   await fs.writeFile(
     path.join(targetDir, "README.md"),

package/template/base/app/page.tsx

@@ -115,7 +115,7 @@ export default function HomePage() {
                 <li>`config/brand.ts` for client identity and contact details.</li>
                 <li>`config/modules.ts` for enabled platform modules.</li>
                 <li>`config/env.ts` for infra requirements and readiness checks.</li>
-                <li>`.env.local` from `.env.example` for per-client secrets and flags.</li>
+                <li>`.env.example` for starter defaults; copy it to `.env.local` for per-client secrets and flags.</li>
               </ul>
             </div>
           </article>

package/template/base/config/bootstrap.ts

@@ -69,7 +69,7 @@ export function getStarterBootstrapChecklist() {
       {
         label: "Create per-client environment variables",
         done: config.envReadiness.allReady,
-        detail: "Copy `.env.example` into `.env.local` and fill the real values.",
+        detail: "Copy `.env.example` to `.env.local` and fill the real values.",
       },
     ],
   };

package/template/modules/admin/app/playground/admin/page.tsx

@@ -20,7 +20,7 @@ export default async function AdminPlaygroundPage() {
             <p className="eyebrow">Admin Module</p>
             <h1>Admin users and roles playground</h1>
             <p className="muted">
-              This route previews the shared admin governance module without relying on the BeGreen client app.
+              This route previews the shared admin governance module without relying on any client-specific app.
             </p>
           </div>
         </article>