create-bw-app 0.14.1 → 0.16.0

package/package.json

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

package/src/constants.mjs

@@ -162,16 +162,16 @@ export const PLATFORM_STARTER_FILES = [
 ];
 
 export const APP_DEPENDENCY_DEFAULTS = {
-  "@brightweblabs/app-shell": "^0.6.1",
-  "@brightweblabs/core-auth": "^0.6.0",
-  "@brightweblabs/infra": "^0.3.3",
-  "@brightweblabs/module-admin": "^0.5.3",
-  "@brightweblabs/module-crm": "^0.8.3",
-  "@brightweblabs/module-marketing": "^0.2.2",
-  "@brightweblabs/module-orgs": "^0.3.3",
-  "@brightweblabs/module-projects": "^0.6.2",
-  "@brightweblabs/theme": "^0.4.0",
-  "@brightweblabs/ui": "^1.1.0",
+  "@brightweblabs/app-shell": "^0.6.2",
+  "@brightweblabs/core-auth": "^0.7.0",
+  "@brightweblabs/infra": "^0.4.0",
+  "@brightweblabs/module-admin": "^0.5.5",
+  "@brightweblabs/module-crm": "^0.8.5",
+  "@brightweblabs/module-marketing": "^0.2.4",
+  "@brightweblabs/module-orgs": "^0.3.5",
+  "@brightweblabs/module-projects": "^0.7.0",
+  "@brightweblabs/theme": "^0.5.0",
+  "@brightweblabs/ui": "^1.1.1",
   "geist": "1.7.2",
   "lucide-react": "^1.8.0",
   "next": "^16.0.0",

package/src/generator.mjs

@@ -305,6 +305,35 @@ function createPlatformBrandConfigFile({ slug, brandValues }) {
     `  supportEmail: ${JSON.stringify(brandValues.supportEmail)},`,
     "};",
     "",
+    "export type StarterShellLogo = {",
+    "  src: string;",
+    "  width: number;",
+    "  height: number;",
+    "};",
+    "",
+    "export type StarterShellBrand = {",
+    "  href: string;",
+    "  ariaLabel: string;",
+    "  alt: string;",
+    "  collapsedLogo: StarterShellLogo;",
+    "  lightLogo: StarterShellLogo;",
+    "  darkLogo: StarterShellLogo;",
+    "};",
+    "",
+    "/**",
+    " * Shell brand marks. This file is written once when the app is scaffolded and",
+    " * is never regenerated, so swapping in client artwork here survives",
+    " * `create-bw-app update` — unlike editing config/shell.ts.",
+    " */",
+    "export const starterShellBrand: StarterShellBrand = {",
+    '  href: "/",',
+    "  ariaLabel: `${starterBrandConfig.companyName} public site`,",
+    "  alt: starterBrandConfig.companyName,",
+    '  collapsedLogo: { src: "/brand/logo-mark.svg", width: 48, height: 48 },',
+    '  lightLogo: { src: "/brand/logo-light.svg", width: 176, height: 44 },',
+    '  darkLogo: { src: "/brand/logo-dark.svg", width: 176, height: 44 },',
+    "};",
+    "",
   ].join("\n");
 }
 
@@ -904,9 +933,9 @@ export function createShellConfig(selectedModules) {
     "  type ShellModuleRegistration,",
     '} from "@brightweblabs/app-shell";',
     ...importLines,
-    'import { starterBrandConfig } from "./brand";',
+    'import { starterShellBrand } from "./brand";',
     'import { getEnabledStarterModules } from "./modules";',
-    'import { shellRegistrationOverrides } from "./shell.overrides";',
+    'import { additionalShellModules, shellRegistrationOverrides } from "./shell.overrides";',
     "",
     "const dashboardModuleRegistration: ShellModuleRegistration<ShellContextualAction> = {",
     '  key: "dashboard",',
@@ -921,6 +950,11 @@ export function createShellConfig(selectedModules) {
     "",
     ...registrationLines,
     "",
+    "  // App-owned surfaces. Declared in config/shell.overrides.ts because",
+    "  // applyShellRegistrationOverrides can only transform existing",
+    "  // registrations, and this file is regenerated by create-bw-app update.",
+    "  registrations.push(...additionalShellModules);",
+    "",
     "  return registrations;",
     "}",
     "",
@@ -931,31 +965,15 @@ export function createShellConfig(selectedModules) {
     "    shellRegistrationOverrides,",
     "  );",
     "  const shellRegistration: ClientAppShellRegistration<ShellContextualAction> = {",
-    "    brand: {",
-    '      href: "/",',
-    '      ariaLabel: `${starterBrandConfig.companyName} public site`,',
-    "      alt: starterBrandConfig.companyName,",
-    "      collapsedLogo: {",
-    '        src: "/brand/logo-mark.svg",',
-    "        width: 48,",
-    "        height: 48,",
-    "      },",
-    "      lightLogo: {",
-    '        src: "/brand/logo-light.svg",',
-    "        width: 176,",
-    "        height: 44,",
-    "      },",
-    "      darkLogo: {",
-    '        src: "/brand/logo-dark.svg",',
-    "        width: 176,",
-    "        height: 44,",
-    "      },",
-    "    },",
+    "    // Logos and the home href live in config/brand.ts, which is written once",
+    "    // at scaffold time and never regenerated — so rebranding survives update.",
+    "    brand: starterShellBrand,",
     "    toolsSection: {",
     '      key: "tools",',
     '      label: "Ferramentas",',
     "      icon: Wrench,",
-    '      collapsedHref: enabledModules.find((moduleConfig) => moduleConfig.routeHref)?.routeHref || "/",',
+    "      collapsedHref: additionalShellModules[0]?.navItems?.[0]?.href",
+    '        ?? enabledModules.find((moduleConfig) => moduleConfig.routeHref)?.routeHref ?? "/",',
     "    },",
     "    modules,",
     "  };",

package/template/base/app/api/cron/keepalive/route.ts

@@ -0,0 +1,2 @@
+export const dynamic = "force-dynamic";
+export { handleKeepaliveGetRequest as GET } from "@brightweblabs/infra/server";

package/template/base/config/brand.ts

@@ -15,3 +15,32 @@ export const starterBrandConfig: StarterBrandConfig = {
   contactEmail: "hello@example.com",
   supportEmail: "support@example.com",
 };
+
+export type StarterShellLogo = {
+  src: string;
+  width: number;
+  height: number;
+};
+
+export type StarterShellBrand = {
+  href: string;
+  ariaLabel: string;
+  alt: string;
+  collapsedLogo: StarterShellLogo;
+  lightLogo: StarterShellLogo;
+  darkLogo: StarterShellLogo;
+};
+
+/**
+ * Shell brand marks. This file is written once when the app is scaffolded and
+ * is never regenerated, so swapping in client artwork here survives
+ * `create-bw-app update` — unlike editing config/shell.ts.
+ */
+export const starterShellBrand: StarterShellBrand = {
+  href: "/",
+  ariaLabel: `${starterBrandConfig.companyName} public site`,
+  alt: starterBrandConfig.companyName,
+  collapsedLogo: { src: "/brand/logo-mark.svg", width: 48, height: 48 },
+  lightLogo: { src: "/brand/logo-light.svg", width: 176, height: 44 },
+  darkLogo: { src: "/brand/logo-dark.svg", width: 176, height: 44 },
+};

package/template/base/config/env.ts

@@ -42,6 +42,13 @@ export const starterEnvRequirements: StarterEnvRequirement[] = [
     description: "Supabase secret key for privileged Admin, CRM, Marketing, and Projects actions.",
     requiredFor: ["crm", "marketing", "projects", "admin"],
   },
+  {
+    key: "SUPABASE_KEEPALIVE_SECRET",
+    scope: "server",
+    description:
+      "Bearer secret for /api/cron/keepalive, which a scheduler calls so free-tier Supabase projects do not idle-pause.",
+    requiredFor: ["core-auth"],
+  },
   {
     key: "RESEND_API_KEY",
     scope: "server",

package/template/base/config/shell.overrides.ts

@@ -1,4 +1,8 @@
-import type { ShellRegistrationOverrides } from "@brightweblabs/app-shell";
+import type {
+  ShellContextualAction,
+  ShellModuleRegistration,
+  ShellRegistrationOverrides,
+} from "@brightweblabs/app-shell";
 
 /**
  * App-owned shell customizations. This scaffolded file is never overwritten by
@@ -14,3 +18,27 @@ import type { ShellRegistrationOverrides } from "@brightweblabs/app-shell";
  * ```
  */
 export const shellRegistrationOverrides: ShellRegistrationOverrides = {};
+
+/**
+ * App-owned nav modules — surfaces this app implements itself, which no
+ * BrightWeb package provides.
+ *
+ * `shellRegistrationOverrides` can only transform registrations that already
+ * exist, so it cannot introduce a new one. Put app-owned surfaces here instead
+ * of editing `config/shell.ts`, which is regenerated by `create-bw-app update`.
+ *
+ * @example An app-owned tool mounted under the Ferramentas section:
+ * ```ts
+ * import { BookOpen } from "lucide-react";
+ *
+ * export const additionalShellModules: ShellModuleRegistration<ShellContextualAction>[] = [
+ *   {
+ *     key: "tools",
+ *     placement: "tools",
+ *     navItems: [{ href: "/ferramentas/conteudos", label: "Conteúdos", icon: BookOpen, visibility: "admin" }],
+ *     toolbarRoutes: [{ surface: "insights-cms", match: { prefixes: ["/ferramentas/conteudos"] } }],
+ *   },
+ * ];
+ * ```
+ */
+export const additionalShellModules: ShellModuleRegistration<ShellContextualAction>[] = [];

package/template/modules/projects/app/(shell)/account/page.tsx

@@ -0,0 +1 @@
+export { ClientAccountPage as default } from "@brightweblabs/module-projects";

package/template/modules/projects/app/(shell)/account/projetos/[projectId]/loading.tsx

@@ -0,0 +1 @@
+export { ClientProjectDetailLoading as default } from "@brightweblabs/module-projects";

package/template/modules/projects/app/(shell)/account/projetos/[projectId]/page.tsx

@@ -0,0 +1 @@
+export { ClientProjectDetailRoute as default } from "@brightweblabs/module-projects";

package/template/modules/projects/app/(shell)/account/projetos/loading.tsx

@@ -0,0 +1 @@
+export { ClientProjectsListLoading as default } from "@brightweblabs/module-projects";

package/template/modules/projects/app/(shell)/account/projetos/page.tsx

@@ -0,0 +1 @@
+export { ClientProjectsListPage as default } from "@brightweblabs/module-projects";