create-bw-app 0.13.2 → 0.14.0

package/README.md

@@ -66,11 +66,11 @@ Current updater behavior:
 
 - prompts for app type: `platform` or `site`
 - prompts for project name
-- prompts for optional platform modules: `admin`, `crm`, and `projects`
+- prompts for optional platform modules: `admin`, `crm`, `marketing`, and `projects`
 - prompts to install dependencies immediately
 - copies a clean Next.js App Router starter template
 - platform apps include BrightWeb auth, shell wiring, and optional direct package mounts
-- generated route files contain direct `@brightweblabs/*` re-exports only
+- generated route files are direct `@brightweblabs/*` re-exports or one-line exports from an app-owned dependency adapter such as Marketing's delivery handler composition
 - platform apps in published mode also write `supabase/config.toml`, a CLI-ready flat `supabase/migrations/` folder, `supabase/module-registry.json`, `supabase/clients/<slug>/stack.json`, and the resolved shared SQL migrations under `supabase/modules/<module>/migrations`
 - site apps include a thin Next.js and Tailwind CSS shell with no default feature page or local component library
 - writes `package.json`, `next.config.ts`, `.gitignore`, and `README.md` for both templates

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-bw-app",
   "private": false,
-  "version": "0.13.2",
+  "version": "0.14.0",
   "type": "module",
   "bin": {
     "create-bw-app": "bin/create-bw-app.mjs",

package/src/app-manifest.mjs

@@ -27,6 +27,7 @@ export const MANAGED_APP_FILES = [
 export const MODULE_PACKAGES = {
   admin: "@brightweblabs/module-admin",
   crm: "@brightweblabs/module-crm",
+  marketing: "@brightweblabs/module-marketing",
   orgs: "@brightweblabs/module-orgs",
   projects: "@brightweblabs/module-projects",
 };
@@ -36,6 +37,7 @@ const FALLBACK_REQUIRES = {
   admin: { core: ">=0.3" },
   orgs: { core: ">=0.3", admin: ">=0.3" },
   crm: { core: ">=0.3", admin: ">=0.3", orgs: ">=0.1" },
+  marketing: { core: ">=0.3", admin: ">=0.3", orgs: ">=0.1", crm: ">=0.6" },
   projects: { core: ">=0.3", admin: ">=0.3", orgs: ">=0.1" },
 };
 
@@ -159,7 +161,7 @@ export async function createInitialAppManifest({ targetDir, slug, template, sele
   const modules = {};
   if (template === "platform") {
     for (const moduleKey of selectedModules) modules[moduleKey] = { version: moduleVersion(moduleKey, versionMap), installedAt: now, exposed: true };
-    if ((selectedModules.includes("crm") || selectedModules.includes("projects")) && !modules.orgs) {
+    if ((selectedModules.includes("crm") || selectedModules.includes("marketing") || selectedModules.includes("projects")) && !modules.orgs) {
       modules.orgs = { version: moduleVersion("orgs", versionMap), installedAt: now, exposed: true };
     }
   }
@@ -250,7 +252,7 @@ export async function readConfiguredModuleFlags(targetDir) {
   if (!(await pathExists(filePath))) return {};
   const content = await fs.readFile(filePath, "utf8");
   const flags = {};
-  for (const key of ["core-auth", "orgs", "crm", "projects", "admin"]) {
+  for (const key of ["core-auth", "orgs", "crm", "marketing", "projects", "admin"]) {
     const match = content.match(new RegExp(`key:\\s*"${key}"[\\s\\S]*?enabled:\\s*(true|false)`));
     if (match) flags[key === "core-auth" ? "core" : key] = match[1] === "true";
   }

package/src/constants.mjs

@@ -21,6 +21,12 @@ export const SELECTABLE_MODULES = [
     packageName: "@brightweblabs/module-crm",
     templateFolder: "crm",
   },
+  {
+    key: "marketing",
+    label: "Marketing",
+    packageName: "@brightweblabs/module-marketing",
+    templateFolder: "marketing",
+  },
   {
     key: "projects",
     label: "Projects",
@@ -55,12 +61,12 @@ export const MODULE_STARTER_FILES = {
   admin: [
     "app/api/admin/users/route.ts",
     "app/api/admin/users/roles/route.ts",
-    "app/admin/users/page.tsx",
+    "app/(shell)/admin/users/page.tsx",
   ],
   crm: [
-    "app/crm/layout.tsx",
-    "app/crm/page.tsx",
-    "app/crm/report/page.tsx",
+    "app/(shell)/crm/layout.tsx",
+    "app/(shell)/crm/page.tsx",
+    "app/(shell)/crm/report/page.tsx",
     "app/api/crm/contacts/route.ts",
     "app/api/crm/organizations/route.ts",
     "app/api/crm/owners/route.ts",
@@ -68,36 +74,107 @@ export const MODULE_STARTER_FILES = {
     "app/api/crm/stats/route.ts",
     "app/api/crm/timeline/route.ts",
   ],
+  marketing: [
+    "app/(shell)/marketing/page.tsx",
+    "app/api/marketing/_handlers.ts",
+    "app/api/marketing/analytics/campaigns/[id]/route.ts",
+    "app/api/marketing/analytics/overview/route.ts",
+    "app/api/marketing/analytics/segments/[id]/route.ts",
+    "app/api/marketing/campaigns/[id]/cancel/route.ts",
+    "app/api/marketing/campaigns/[id]/recipients/route.ts",
+    "app/api/marketing/campaigns/[id]/retry/route.ts",
+    "app/api/marketing/campaigns/[id]/route.ts",
+    "app/api/marketing/campaigns/[id]/schedule/route.ts",
+    "app/api/marketing/campaigns/[id]/send/route.ts",
+    "app/api/marketing/campaigns/[id]/test/route.ts",
+    "app/api/marketing/campaigns/route.ts",
+    "app/api/marketing/segments/[id]/preview/route.ts",
+    "app/api/marketing/segments/[id]/route.ts",
+    "app/api/marketing/segments/preview/route.ts",
+    "app/api/marketing/segments/route.ts",
+    "app/api/marketing/topics/route.ts",
+    "app/api/marketing/unsubscribe/[token]/route.ts",
+    "app/api/marketing/webhooks/resend/route.ts",
+    "app/api/marketing/worker/route.ts",
+    "app/api/marketing/workflows/[id]/activate/route.ts",
+    "app/api/marketing/workflows/[id]/nodes/[nodeId]/route.ts",
+    "app/api/marketing/workflows/[id]/nodes/route.ts",
+    "app/api/marketing/workflows/[id]/pause/route.ts",
+    "app/api/marketing/workflows/[id]/route.ts",
+    "app/api/marketing/workflows/[id]/runs/route.ts",
+    "app/api/marketing/workflows/route.ts",
+  ],
   projects: [
+    "app/(shell)/projects/layout.tsx",
+    "app/(shell)/projects/page.tsx",
+    "app/(shell)/projects/projects-live-mounts.tsx",
+    "app/(shell)/projects/projects-server-mounts.tsx",
+    "app/(shell)/projects/[id]/page.tsx",
+    "app/(shell)/projects/[id]/board/page.tsx",
+    "app/(shell)/projects/[id]/tasks/page.tsx",
+    "app/api/projects/_handlers.ts",
+    "app/api/projects/route.ts",
+    "app/api/projects/stats/route.ts",
+    "app/api/projects/organizations/route.ts",
+    "app/api/projects/[id]/route.ts",
+    "app/api/projects/[id]/activity/route.ts",
+    "app/api/projects/[id]/members/route.ts",
+    "app/api/projects/[id]/links/route.ts",
+    "app/api/projects/[id]/links/[itemId]/route.ts",
+    "app/api/projects/[id]/milestones/route.ts",
+    "app/api/projects/[id]/milestones/[itemId]/route.ts",
+    "app/api/projects/[id]/tasks/route.ts",
+    "app/api/projects/[id]/tasks/[itemId]/route.ts",
   ],
 };
 
 export const PLATFORM_STARTER_FILES = [
+  "app/(auth)/auth-provider.tsx",
+  "app/(auth)/layout.tsx",
+  "app/(auth)/login/page.tsx",
+  "app/(auth)/signup/page.tsx",
+  "app/(auth)/forgot-password/page.tsx",
+  "app/(auth)/reset-password/page.tsx",
+  "app/(auth)/auth/post-login/page.tsx",
+  "app/(auth)/auth/confirmed/page.tsx",
+  "app/(auth)/invite/[invitationId]/page.tsx",
+  "app/(auth)/invite/[invitationId]/invite-route-mount.tsx",
+  "app/(shell)/layout.tsx",
+  "app/(shell)/shell-layout-client.tsx",
+  "app/(shell)/account/page.tsx",
+  "app/(shell)/dashboard/dashboard-live-mount.tsx",
+  "app/(shell)/dashboard/page.tsx",
+  "app/api/account/route.ts",
+  "app/auth/callback/route.ts",
+  "app/auth/cleanup/route.ts",
+  "app/layout.tsx",
+  "config/env.ts",
   "config/shell.overrides.ts",
 ];
 
 export const APP_DEPENDENCY_DEFAULTS = {
-  "@brightweblabs/app-shell": "^0.6.0",
-  "@brightweblabs/core-auth": "^0.4.0",
-  "@brightweblabs/infra": "^0.3.2",
-  "@brightweblabs/module-admin": "^0.5.0",
-  "@brightweblabs/module-crm": "^0.8.0",
-  "@brightweblabs/module-orgs": "^0.3.0",
-  "@brightweblabs/module-projects": "^0.5.0",
+  "@brightweblabs/app-shell": "^0.6.1",
+  "@brightweblabs/core-auth": "^0.5.1",
+  "@brightweblabs/infra": "^0.3.3",
+  "@brightweblabs/module-admin": "^0.5.2",
+  "@brightweblabs/module-crm": "^0.8.2",
+  "@brightweblabs/module-marketing": "^0.2.1",
+  "@brightweblabs/module-orgs": "^0.3.2",
+  "@brightweblabs/module-projects": "^0.6.1",
   "@brightweblabs/theme": "^0.4.0",
   "@brightweblabs/ui": "^1.1.0",
   "geist": "1.7.2",
   "lucide-react": "^1.8.0",
-  "next": "16.1.6",
-  "react": "19.2.4",
-  "react-dom": "19.2.4",
+  "next": "^16.0.0",
+  "react": "^19.0.0",
+  "react-dom": "^19.0.0",
 };
 
 export const SITE_DEPENDENCY_DEFAULTS = {
   "geist": "1.7.2",
-  "next": "16.1.6",
-  "react": "19.2.4",
-  "react-dom": "19.2.4",
+  "next": "^16.0.0",
+  "react": "^19.0.0",
+  "react-dom": "^19.0.0",
 };
 
 export const APP_DEV_DEPENDENCY_DEFAULTS = {
@@ -131,7 +208,7 @@ Usage:
 Scaffold 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
+  --modules <list>               Comma-separated modules: crm,marketing,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

package/src/doctor.mjs

@@ -7,6 +7,34 @@ import { pathExists, readJsonIfPresent } from "./generator.mjs";
 import { scaffoldDrift } from "./scaffold.mjs";
 
 const HELP = `Usage: bw doctor [options]\n\nOptions:\n  --target-dir <path>       App directory (defaults to cwd)\n  --workspace-root <path>   BrightWeb workspace root\n  --strict                  Treat warnings as failures\n  --report                  Stamp lastDoctor in the app manifest\n  --help                    Show this help`;
+const RUNTIME_PACKAGE_NAMES = ["react", "react-dom", "next"];
+
+export async function findInstalledRuntimeVersions(targetDir) {
+  const storeDir = path.join(targetDir, "node_modules", ".pnpm");
+  if (!(await pathExists(storeDir))) {
+    return Object.fromEntries(RUNTIME_PACKAGE_NAMES.map((packageName) => [packageName, []]));
+  }
+
+  const entries = await fs.readdir(storeDir, { withFileTypes: true });
+  const resolved = {};
+  for (const packageName of RUNTIME_PACKAGE_NAMES) {
+    const versions = new Set();
+    for (const entry of entries) {
+      if (!entry.isDirectory() || !entry.name.startsWith(`${packageName}@`)) continue;
+      const manifest = await readJsonIfPresent(
+        path.join(storeDir, entry.name, "node_modules", packageName, "package.json"),
+      );
+      const fallbackVersion = entry.name
+        .slice(packageName.length + 1)
+        .split("_", 1)[0]
+        .split("(", 1)[0];
+      const version = manifest?.version || fallbackVersion;
+      if (version) versions.add(version);
+    }
+    resolved[packageName] = Array.from(versions).sort();
+  }
+  return resolved;
+}
 
 export async function doctorBrightwebApp(argvOptions = {}, runtimeOptions = {}) {
   if (argvOptions.help) { output.write(`${HELP}\n`); return { help: true, ok: true }; }
@@ -35,6 +63,16 @@ export async function doctorBrightwebApp(argvOptions = {}, runtimeOptions = {})
   }
   add(packageProblems.length ? "FAIL" : "PASS", "packages", packageProblems.join("; ") || "Installed module packages agree with the manifest.");
 
+  const runtimeVersions = await findInstalledRuntimeVersions(targetDir);
+  const duplicateRuntimes = Object.entries(runtimeVersions)
+    .filter(([, versions]) => versions.length > 1)
+    .map(([packageName, versions]) => `${packageName}: ${versions.join(", ")}`);
+  add(
+    duplicateRuntimes.length ? "FAIL" : "PASS",
+    "runtime-singletons",
+    duplicateRuntimes.join("; ") || "React, React DOM, and Next resolve to at most one version each.",
+  );
+
   const flags = await readConfiguredModuleFlags(targetDir);
   const exposureProblems = Object.entries(appManifest.modules || {}).filter(([key, entry]) => typeof flags[key] === "boolean" && flags[key] !== entry.exposed).map(([key, entry]) => `${key}: manifest exposed=${entry.exposed}, config enabled=${String(flags[key])}`);
   add(exposureProblems.length ? "FAIL" : "PASS", "exposure", exposureProblems.join("; ") || "Module exposure flags agree.");

package/src/generator.mjs

@@ -28,6 +28,7 @@ const DEFAULT_DB_MODULE_REGISTRY = {
     admin: { label: "Admin", dependsOn: ["core"] },
     orgs: { label: "Organizations", dependsOn: ["core", "admin"] },
     crm: { label: "CRM", dependsOn: ["core", "admin", "orgs"] },
+    marketing: { label: "Marketing", dependsOn: ["core", "admin", "orgs", "crm"] },
     projects: { label: "Projects", dependsOn: ["core", "admin", "orgs"] },
   },
 };
@@ -251,6 +252,7 @@ export async function getVersionMap(workspaceRoot) {
     "@brightweblabs/infra",
     "@brightweblabs/module-admin",
     "@brightweblabs/module-crm",
+    "@brightweblabs/module-marketing",
     "@brightweblabs/module-orgs",
     "@brightweblabs/module-projects",
     "@brightweblabs/theme",
@@ -264,6 +266,10 @@ export async function getVersionMap(workspaceRoot) {
     }
   }
 
+  versionMap.next = APP_DEPENDENCY_DEFAULTS.next;
+  versionMap.react = APP_DEPENDENCY_DEFAULTS.react;
+  versionMap["react-dom"] = APP_DEPENDENCY_DEFAULTS["react-dom"];
+
   return versionMap;
 }
 
@@ -304,10 +310,10 @@ function createPlatformBrandConfigFile({ slug, brandValues }) {
 
 export function createPlatformModulesConfigFile(selectedModules) {
   const selected = new Set(selectedModules);
-  const orgsEnabled = selected.has("crm") || selected.has("projects");
+  const orgsEnabled = selected.has("crm") || selected.has("marketing") || selected.has("projects");
 
   return [
-    'export type StarterModuleKey = "core-auth" | "orgs" | "crm" | "projects" | "admin";',
+    'export type StarterModuleKey = "core-auth" | "orgs" | "crm" | "marketing" | "projects" | "admin";',
     "",
     "export type StarterModuleConfig = {",
     "  key: StarterModuleKey;",
@@ -331,7 +337,7 @@ export function createPlatformModulesConfigFile(selectedModules) {
     "  {",
     '    key: "orgs",',
     '    label: "Organizations",',
-    '    description: "Shared organizations, membership, and invitation foundation for CRM and Projects.",',
+    '    description: "Shared organizations, membership, and invitation foundation for CRM, Marketing, and Projects.",',
     `    enabled: ${String(orgsEnabled)},`,
     '    packageName: "@brightweblabs/module-orgs",',
     '    placement: "hidden",',
@@ -346,11 +352,21 @@ export function createPlatformModulesConfigFile(selectedModules) {
     '    placement: "primary",',
     "  },",
     "  {",
+    '    key: "marketing",',
+    '    label: "Marketing",',
+    '    description: "Consent-first campaigns, segments, analytics, and automated email workflows.",',
+    `    enabled: ${String(selected.has("marketing"))},`,
+    '    packageName: "@brightweblabs/module-marketing",',
+    '    routeHref: "/marketing",',
+    '    placement: "primary",',
+    "  },",
+    "  {",
     '    key: "projects",',
     '    label: "Projects",',
     '    description: "Project portfolio, detail routes, and work-management server logic.",',
     `    enabled: ${String(selected.has("projects"))},`,
     '    packageName: "@brightweblabs/module-projects",',
+    '    routeHref: "/projects",',
     '    placement: "primary",',
     "  },",
     "  {",
@@ -374,15 +390,20 @@ export function createPlatformModulesConfigFile(selectedModules) {
 function createEnvFileContent() {
   return [
     "NEXT_PUBLIC_APP_URL=http://localhost:3000",
+    "PUBLIC_APP_URL=http://localhost:3000",
     "NEXT_PUBLIC_SUPABASE_URL=",
     "NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=",
     "SUPABASE_SECRET_DEFAULT_KEY=",
     "RESEND_API_KEY=",
+    "RESEND_WEBHOOK_SECRET=",
     "RESEND_FROM_TRANSACTIONAL=",
     "RESEND_FROM_MARKETING=",
-    "CONTACT_TO_EMAIL=",
-    "RESEND_WEBHOOK_SECRET=",
+    "RESEND_FROM_EMAIL=",
+    "RESEND_FROM_NAME=",
+    "MARKETING_FROM_EMAIL=",
+    "MARKETING_FROM_NAME=BrightWeb",
     "MARKETING_WORKER_SECRET=",
+    "CONTACT_TO_EMAIL=",
     "MARKETING_TEST_EMAIL=",
     "",
   ].join("\n");
@@ -436,11 +457,21 @@ function createGitignore() {
 }
 
 function getPlatformStarterRoutes(selectedModules) {
-  return selectedModules.flatMap((moduleKey) => {
-    if (moduleKey === "crm") return ["/crm"];
-    if (moduleKey === "admin") return ["/admin/users"];
-    return [];
-  });
+  return [
+    "/login",
+    "/signup",
+    "/forgot-password",
+    "/reset-password",
+    "/account",
+    "/dashboard",
+    ...selectedModules.flatMap((moduleKey) => {
+      if (moduleKey === "crm") return ["/crm"];
+      if (moduleKey === "marketing") return ["/marketing"];
+      if (moduleKey === "projects") return ["/projects"];
+      if (moduleKey === "admin") return ["/admin/users"];
+      return [];
+    }),
+  ];
 }
 
 function getSiteStarterRoutes() {
@@ -675,7 +706,7 @@ export function createAppContextFile({
         ],
         packageOwned: [
           ...CORE_PACKAGES,
-          ...(selectedModules.includes("crm") || selectedModules.includes("projects") ? [ORGS_PACKAGE_NAME] : []),
+          ...(selectedModules.includes("crm") || selectedModules.includes("marketing") || selectedModules.includes("projects") ? [ORGS_PACKAGE_NAME] : []),
           ...SELECTABLE_MODULES
             .filter((moduleDefinition) => selectedModules.includes(moduleDefinition.key))
             .map((moduleDefinition) => moduleDefinition.packageName),
@@ -748,7 +779,7 @@ export function createPackageJson({
       dependencies[moduleDefinition.packageName] = internalDependencyVersion(moduleDefinition.packageName);
     }
   }
-  if (selectedModules.includes("crm") || selectedModules.includes("projects")) {
+  if (selectedModules.includes("crm") || selectedModules.includes("marketing") || selectedModules.includes("projects")) {
     dependencies[ORGS_PACKAGE_NAME] = internalDependencyVersion(ORGS_PACKAGE_NAME);
   }
 
@@ -787,7 +818,7 @@ export function createNextConfig({ template, selectedModules }) {
   }
 
   const transpilePackages = [...CORE_PACKAGES];
-  if (selectedModules.includes("crm") || selectedModules.includes("projects")) {
+  if (selectedModules.includes("crm") || selectedModules.includes("marketing") || selectedModules.includes("projects")) {
     transpilePackages.push(ORGS_PACKAGE_NAME);
   }
 
@@ -836,7 +867,7 @@ export function createShellConfig(selectedModules) {
   const importLines = [];
   const registrationLines = [];
 
-  if (selectedModules.includes("crm") || selectedModules.includes("projects")) {
+  if (selectedModules.includes("crm") || selectedModules.includes("marketing") || selectedModules.includes("projects")) {
     importLines.push('import { orgsModuleRegistration } from "@brightweblabs/module-orgs/registration";');
     registrationLines.push('  if (enabled.has("orgs")) registrations.push(orgsModuleRegistration);');
   }
@@ -851,9 +882,19 @@ export function createShellConfig(selectedModules) {
     registrationLines.push('  if (enabled.has("crm")) registrations.push(crmModuleRegistration);');
   }
 
+  if (selectedModules.includes("marketing")) {
+    importLines.push('import { marketingModuleRegistration } from "@brightweblabs/module-marketing/registration";');
+    registrationLines.push('  if (enabled.has("marketing")) registrations.push(marketingModuleRegistration);');
+  }
+
+  if (selectedModules.includes("projects")) {
+    importLines.push('import { projectsPreviewModuleRegistration } from "@brightweblabs/module-projects/registration";');
+    registrationLines.push('  if (enabled.has("projects")) registrations.push(projectsPreviewModuleRegistration);');
+  }
+
   return [
     "// MANAGED BY BRIGHTWEB — regenerated by create-bw-app update; put customizations in config/shell.overrides.ts",
-    'import { Wrench } from "lucide-react";',
+    'import { LayoutDashboard, Wrench } from "lucide-react";',
     "import {",
     "  applyShellRegistrationOverrides,",
     "  buildClientAppShellRegistration,",
@@ -867,9 +908,16 @@ export function createShellConfig(selectedModules) {
     'import { getEnabledStarterModules } from "./modules";',
     'import { shellRegistrationOverrides } from "./shell.overrides";',
     "",
+    "const dashboardModuleRegistration: ShellModuleRegistration<ShellContextualAction> = {",
+    '  key: "dashboard",',
+    '  placement: "primary",',
+    '  navItems: [{ href: "/dashboard", label: "Dashboard", icon: LayoutDashboard }],',
+    '  toolbarRoutes: [{ surface: "dashboard", match: { exact: ["/dashboard"] } }],',
+    "};",
+    "",
     "function getStarterModuleRegistrations() {",
     '  const enabled = new Set(getEnabledStarterModules().map((moduleConfig) => moduleConfig.key));',
-    "  const registrations: ShellModuleRegistration<ShellContextualAction>[] = [];",
+    "  const registrations: ShellModuleRegistration<ShellContextualAction>[] = [dashboardModuleRegistration];",
     "",
     ...registrationLines,
     "",
@@ -923,6 +971,8 @@ export function createShellConfig(selectedModules) {
     "    shellConfig: builtRegistration.shellConfig,",
     "    shellPreview,",
     "    toolbarRoutes: builtRegistration.toolbarRoutes,",
+    "    toolbarActions: builtRegistration.toolbarActions,",
+    "    dashboardContributions: builtRegistration.dashboardContributions,",
     "  };",
     "}",
     "",
@@ -1430,13 +1480,19 @@ export async function createBrightwebClientApp(argvOptions, runtimeOptions = {})
     workspaceMode,
     registry: dbModuleRegistry,
   });
+  const requestedModules = new Set(answers.selectedModules);
+  const selectedModules = dbInstallPlan.resolvedOrder.filter(
+    (moduleKey) =>
+      SELECTABLE_MODULES.some((moduleDefinition) => moduleDefinition.key === moduleKey)
+      && (moduleKey !== "admin" || requestedModules.has("admin")),
+  );
   const install = answers.install && !argvOptions.dryRun;
 
   if (argvOptions.dryRun) {
     output.write(`${renderPlanSummary({
       targetDir,
       dependencyMode,
-      selectedModules: answers.selectedModules,
+      selectedModules,
       packageManager,
       workspaceMode,
       install: answers.install,
@@ -1456,7 +1512,7 @@ export async function createBrightwebClientApp(argvOptions, runtimeOptions = {})
   output.write(`${renderPlanSummary({
     targetDir,
     dependencyMode,
-    selectedModules: answers.selectedModules,
+    selectedModules,
     packageManager,
     workspaceMode,
     install: answers.install,
@@ -1476,7 +1532,7 @@ export async function createBrightwebClientApp(argvOptions, runtimeOptions = {})
   } else {
     await scaffoldPlatformProject({
       targetDir,
-      selectedModules: answers.selectedModules,
+      selectedModules,
       versionMap,
       dependencyMode,
       packageManager,

package/template/base/app/(auth)/auth/confirmed/page.tsx

@@ -0,0 +1 @@
+export { AuthConfirmedPage as default } from "@brightweblabs/core-auth/ui";

package/template/base/app/(auth)/auth/post-login/page.tsx

@@ -0,0 +1 @@
+export { PostLoginPage as default } from "@brightweblabs/core-auth/ui";

package/template/base/app/(auth)/auth-provider.tsx

@@ -0,0 +1,25 @@
+"use client";
+
+import { AuthUiProvider, createAuthUiClient } from "@brightweblabs/core-auth/ui";
+import { starterBrandConfig } from "../../config/brand";
+
+const authClient = createAuthUiClient();
+
+export function AuthProvider({ children }: { children: React.ReactNode }) {
+  return (
+    <AuthUiProvider
+      client={authClient}
+      signupMode="invite-only"
+      layoutVariant="split"
+      brand={{
+        companyName: starterBrandConfig.companyName,
+        helpHref: `mailto:${starterBrandConfig.supportEmail}`,
+        splitHeadline: "Operações claras. Decisões com contexto.",
+        splitDescription: "Um espaço reservado para equipas e clientes acompanharem projetos, relações e trabalho em curso.",
+        logo: <img src="/brand/logo-dark.svg" alt={starterBrandConfig.companyName} width={176} height={44} />,
+      }}
+    >
+      {children}
+    </AuthUiProvider>
+  );
+}

package/template/base/app/(auth)/forgot-password/page.tsx

@@ -0,0 +1 @@
+export { ForgotPasswordPage as default } from "@brightweblabs/core-auth/ui";

package/template/base/app/(auth)/invite/[invitationId]/invite-route-mount.tsx

@@ -0,0 +1,10 @@
+import { InvitePage } from "@brightweblabs/core-auth/ui";
+
+export async function InviteRouteMount({
+  params,
+}: {
+  params: Promise<{ invitationId: string }>;
+}) {
+  const { invitationId } = await params;
+  return <InvitePage invitationId={invitationId} />;
+}

package/template/base/app/(auth)/invite/[invitationId]/page.tsx

@@ -0,0 +1 @@
+export { InviteRouteMount as default } from "./invite-route-mount";

package/template/base/app/(auth)/layout.tsx

@@ -0,0 +1,5 @@
+import { AuthProvider } from "./auth-provider";
+
+export default function AuthLayout({ children }: { children: React.ReactNode }) {
+  return <AuthProvider>{children}</AuthProvider>;
+}

package/template/base/app/(auth)/login/page.tsx

@@ -0,0 +1 @@
+export { LoginPage as default } from "@brightweblabs/core-auth/ui";

package/template/base/app/(auth)/reset-password/page.tsx

@@ -0,0 +1 @@
+export { ResetPasswordPage as default } from "@brightweblabs/core-auth/ui";

package/template/base/app/(auth)/signup/page.tsx

@@ -0,0 +1 @@
+export { SignupPage as default } from "@brightweblabs/core-auth/ui";

package/template/base/app/(shell)/account/page.tsx

@@ -0,0 +1,5 @@
+import { AccountPage } from "@brightweblabs/core-auth";
+
+export default function Page() {
+  return <AccountPage />;
+}

package/template/base/app/(shell)/dashboard/dashboard-live-mount.tsx

@@ -0,0 +1,21 @@
+"use client";
+
+import { AppDashboard, type DashboardDataClient } from "@brightweblabs/app-shell";
+import { getStarterShellConfig } from "../../../config/shell";
+
+async function getJson(path: string) {
+  const response = await fetch(path);
+  return response.json();
+}
+
+const dashboardClient: DashboardDataClient = {
+  getOverview: () => Promise.reject(new Error("No aggregate dashboard endpoint configured.")),
+  getProjects: () => getJson("/api/projects/stats"),
+  getCrm: () => getJson("/api/crm/stats"),
+  getTasks: () => Promise.reject(new Error("No task dashboard endpoint configured.")),
+};
+
+export function DashboardLiveMount() {
+  const { dashboardContributions } = getStarterShellConfig();
+  return <AppDashboard client={dashboardClient} contributions={dashboardContributions} />;
+}

package/template/base/app/(shell)/dashboard/page.tsx

@@ -0,0 +1 @@
+export { DashboardLiveMount as default } from "./dashboard-live-mount";

package/template/base/app/(shell)/layout.tsx

@@ -0,0 +1,24 @@
+import type { ReactNode } from "react";
+import { requireServerPageAccess } from "@brightweblabs/core-auth/server";
+import { ShellLayoutClient, type ShellViewer } from "./shell-layout-client";
+
+export const dynamic = "force-dynamic";
+
+export default async function ShellLayout({ children }: Readonly<{ children: ReactNode }>) {
+  const { supabase, user, role } = await requireServerPageAccess();
+  const { data: profile } = await supabase
+    .from("profiles")
+    .select("first_name, last_name")
+    .eq("user_id", user.id)
+    .maybeSingle<{ first_name: string | null; last_name: string | null }>();
+
+  const viewer: ShellViewer = {
+    email: user.email ?? null,
+    firstName: profile?.first_name ?? null,
+    lastName: profile?.last_name ?? null,
+    isAdmin: role === "admin",
+    isStaff: role === "staff" || role === "admin",
+  };
+
+  return <ShellLayoutClient viewer={viewer}>{children}</ShellLayoutClient>;
+}