@clubedge/create-clubedge-app 0.42.0 → 0.42.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to `create-clubedge-app` are documented here.
 
+## 0.42.1
+
+- Default to Starter `v0.27.1` (#140): new projects carry the Clubedge Starter brand, and their mobile app shows it.
+  - Each web app's logo is the new mark, shown whole: the pages no longer round its corners. Each app also has `favicon.ico`, a new `favicon.svg`, and an Apple touch icon.
+  - The mobile app shows the logo on its pages. The logo was in a `.well-known` folder, which Android leaves out of an app, so the Vite app now bundles it.
+  - The mobile app's icons and splash screens are made from `apps/shell/assets/logo.svg` instead of Capacitor's default.
+  - Upgrading: a logo you replaced comes back as a conflict in `logo.svg`, so keep yours. The [Starter's release notes](https://github.com/Clubedge/clubedge-starter/releases/tag/v0.27.1) cover replaced favicons and existing `android/` and `ios/` projects.
+
 ## 0.42.0
 
 - **Mobile apps with Capacitor**: default to Starter `v0.27.0` (#138). `--framework vite --api hono --shell capacitor` (or `--api fastapi`) packages the Vite frontend as an Android and iOS app in `apps/shell` (#135):

package/README.md

@@ -223,7 +223,7 @@ pnpm dlx @clubedge/create-clubedge-app my-app --yes --no-git --framework tanstac
 pnpm dlx @clubedge/create-clubedge-app my-app --ref main
 
 # Reproduce a specific Starter release or commit
-pnpm dlx @clubedge/create-clubedge-app my-app --ref v0.27.0
+pnpm dlx @clubedge/create-clubedge-app my-app --ref v0.27.1
 pnpm dlx @clubedge/create-clubedge-app my-app --ref <commit-sha>
 
 # Test local Starter changes before releasing them
@@ -242,7 +242,7 @@ pnpm clubedge add email resend payments stripe              # several modules as
 pnpm clubedge remove storage payments
 pnpm dlx @clubedge/create-clubedge-app add infra local --dry-run
 pnpm dlx @clubedge/create-clubedge-app@latest upgrade        # to the newest CLI's Starter release
-pnpm dlx @clubedge/create-clubedge-app upgrade --ref v0.27.0 # or a specific tag, branch, or commit
+pnpm dlx @clubedge/create-clubedge-app upgrade --ref v0.27.1 # or a specific tag, branch, or commit
 ```
 
 The CLI renders the project twice, from the Starter commit and modules recorded in your `package.json` and from the new state, and merges the difference into your project. The new state has other modules for `add` and `remove`, and the newer Starter with the same modules for `upgrade`. Modules a newer Starter introduces start as `none` where possible, so an upgrade never adds a service on its own.
@@ -358,7 +358,7 @@ docker compose --env-file .env.production run --rm web node /app/migrate.mjs   #
 docker compose --env-file .env.production up -d  # --build builds the images on the server
 ```
 
-`deploy` prints these steps, with the `IMAGE_PREFIX` of your repository when `origin` is on GitHub. To update, publish a release, then on the server `docker compose --env-file .env.production pull` (or set `TAG` to the new version), run the migrations, and `up -d` again. Running `deploy` again writes the files that are missing and never overwrites one: it keeps a `Caddyfile` or workflow you changed, and says so, and stops when `compose.yaml` differs from the one it writes, so move yours away to get the new one. Compose prefers `compose.yaml` to the Starter's `docker-compose.yml`, so run the local one by name: `docker compose -f docker-compose.yml up --build`, which `pnpm docker:dev` does since Starter v0.27.0.
+`deploy` prints these steps, with the `IMAGE_PREFIX` of your repository when `origin` is on GitHub. To update, publish a release, then on the server `docker compose --env-file .env.production pull` (or set `TAG` to the new version), run the migrations, and `up -d` again. Running `deploy` again writes the files that are missing and never overwrites one: it keeps a `Caddyfile` or workflow you changed, and says so, and stops when `compose.yaml` differs from the one it writes, so move yours away to get the new one. Compose prefers `compose.yaml` to the Starter's `docker-compose.yml`, so run the local one by name: `docker compose -f docker-compose.yml up --build`, which `pnpm docker:dev` does since Starter v0.27.1.
 
 ### Client addresses
 
@@ -381,27 +381,27 @@ Projects created with `--infra neon` also have `.github/workflows/preview.yml`,
 Each CLI release is tested against one specific Starter release:
 
 ```text
-create-clubedge-app v0.42.0
+create-clubedge-app v0.42.1
         |
         v
-Clubedge Starter v0.27.0
-commit 5f0e7e57131c4c56305d67edfd2e7366618d7b7c
+Clubedge Starter v0.27.1
+commit 997d71d74775352d30dc2bb25017f46ef43f4fd8
 ```
 
 The current relationship is:
 
 | CLI release | Default Starter release | Meaning |
 | --- | --- | --- |
-| `create-clubedge-app@0.42.0` | `clubedge-starter@v0.27.0` | The CLI's required, tested default |
+| `create-clubedge-app@0.42.1` | `clubedge-starter@v0.27.1` | The CLI's required, tested default |
 
 This means the same CLI version always scaffolds the same Starter revision by default. The CLI does not silently follow Starter `main`.
 
-The `v0.27.0` tag is expected to resolve to commit
-`5f0e7e57131c4c56305d67edfd2e7366618d7b7c`. The CLI verifies this before
+The `v0.27.1` tag is expected to resolve to commit
+`997d71d74775352d30dc2bb25017f46ef43f4fd8`. The CLI verifies this before
 scaffolding with the default reference and fails rather than silently using a
 moved tag.
 
-When the Starter changes, its maintainers first publish a new versioned release, such as `v0.27.0`. The CLI is then updated to use that release, all generated-project checks must pass, and a new CLI version is published. This keeps Starter and CLI releases independently versioned while preserving a tested compatibility relationship.
+When the Starter changes, its maintainers first publish a new versioned release, such as `v0.27.1`. The CLI is then updated to use that release, all generated-project checks must pass, and a new CLI version is published. This keeps Starter and CLI releases independently versioned while preserving a tested compatibility relationship.
 
 Every generated project records its CLI version, Starter repository, Starter ref, Starter commit, framework, and modules in `package.json` and `README.md`.
 
@@ -456,7 +456,7 @@ CI packs the CLI with `npm pack`, scaffolds clean projects from the packed tarba
 1. Make and validate changes in `clubedge-starter`.
 2. Run lint, typecheck, unit tests, browser tests, and production build.
 3. Update the Starter package versions.
-4. Commit `main`, create a release tag such as `v0.27.0`, and publish the Starter release.
+4. Commit `main`, create a release tag such as `v0.27.1`, and publish the Starter release.
 
 ### CLI maintainers
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/create-clubedge-app",
-  "version": "0.42.0",
+  "version": "0.42.1",
   "description": "Create React apps from Clubedge Starter with a CLI or local MCP server.",
   "type": "module",
   "packageManager": "pnpm@10.9.0",
@@ -24,8 +24,8 @@
   },
   "clubedge": {
     "starterRepository": "Clubedge/clubedge-starter",
-    "starterRef": "v0.27.0",
-    "starterCommit": "5f0e7e57131c4c56305d67edfd2e7366618d7b7c"
+    "starterRef": "v0.27.1",
+    "starterCommit": "997d71d74775352d30dc2bb25017f46ef43f4fd8"
   },
   "license": "Apache-2.0",
   "repository": {

package/template/SETUP.md

@@ -748,7 +748,7 @@ Installed apps keep calling the contract they shipped with, so change `openapi.y
 
 1. Set your app's id in `apps/shell/capacitor.config.ts`: a reverse-domain name you own, such as `com.yourcompany.app`. It becomes permanent once the Android and iOS projects exist and a store lists the app, so set it before the first build. The app's name comes from `apps/web/src/config/site.json`.
 2. Set `WEB_URL` in `apps/shell/.env.local` to the website's public `https://` address, such as `https://app.example.com`. The build refuses any other: the app sends its session there.
-3. Run `pnpm --filter @clubedge/shell android` (or `ios`). It builds the web app for the app, creates `apps/shell/android` (or `apps/shell/ios`) on the first run, copies the build into it, and opens Android Studio (or Xcode), where you run the app on a device or an emulator. Commit `android/` and `ios/`: from then on they are your app's own, with its icons, permissions, and signing settings.
+3. Run `pnpm --filter @clubedge/shell android` (or `ios`). It builds the web app for the app, creates `apps/shell/android` (or `apps/shell/ios`) on the first run, copies the build into it, and opens Android Studio (or Xcode), where you run the app on a device or an emulator. Commit `android/` and `ios/`: from then on they are your app's own, with its icons, permissions, and signing settings. The first run also makes the app's icons and splash screens from `apps/shell/assets/logo.svg`, the white mark on the brand's blue square, with Capacitor's asset tool (run through npx, so it needs the network then); after changing it, run `pnpm --filter @clubedge/shell icons`, and set the backgrounds to match it at the top of `apps/shell/scripts/icons.mjs`.
 
 After changing the web app, `pnpm --filter @clubedge/shell sync` copies a new build into the native projects. Release builds and store listings are made in Android Studio and Xcode, as Capacitor's guides for [Google Play](https://capacitorjs.com/docs/android/deploying-to-google-play) and the [App Store](https://capacitorjs.com/docs/ios/deploying-to-app-store) describe. The project's CI builds a debug APK too; set a `WEB_URL` repository variable so that it calls your website.
 

package/template/apps/api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/api",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/apps/api-fastapi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/api-fastapi",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/apps/api-fastapi/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "clubedge-api"
-version = "0.27.0"
+version = "0.27.1"
 description = "The project's API, implementing packages/contract/openapi.yaml."
 requires-python = ">=3.12"
 dependencies = [

package/template/apps/api-fastapi/uv.lock

@@ -304,7 +304,7 @@ wheels = [
 
 [[package]]
 name = "clubedge-api"
-version = "0.27.0"
+version = "0.27.1"
 source = { editable = "." }
 default-groups = "all"
 dependencies = [

package/template/apps/capacitor/assets/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512" role="img" aria-label="Clubedge Starter"><title>Clubedge Starter</title><rect width="512" height="512" fill="#2563EB"/><g fill="#FFFFFF"><rect x="138.24" y="138.24" width="67.291" height="67.291" rx="12.617"/><rect x="222.354" y="138.24" width="67.291" height="67.291" rx="12.617"/><rect x="138.24" y="222.354" width="67.291" height="67.291" rx="12.617"/><rect x="138.24" y="306.468" width="67.291" height="67.291" rx="12.617"/><rect x="222.354" y="306.468" width="67.291" height="67.291" rx="12.617"/><circle cx="340.114" cy="171.886" r="33.645"/><circle cx="340.114" cy="340.114" r="33.645"/></g></svg>

package/template/apps/capacitor/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@clubedge/capacitor",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",
   "scripts": {
     "android": "node --env-file-if-exists=.env.local scripts/build.mjs android --open",
+    "icons": "node scripts/icons.mjs",
     "ios": "node --env-file-if-exists=.env.local scripts/build.mjs ios --open",
     "sync": "node --env-file-if-exists=.env.local scripts/build.mjs",
     "typecheck": "tsc --noEmit"

package/template/apps/capacitor/scripts/build.mjs

@@ -11,6 +11,7 @@ import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
+import { makeIcons } from "./icons.mjs";
 
 const shellDirectory = join(import.meta.dirname, "..");
 const webDirectory = join(import.meta.dirname, "../../web");
@@ -87,7 +88,10 @@ function build(args) {
   const capacitor = join(shellDirectory, "node_modules/@capacitor/cli/bin/capacitor");
   for (const platform of targets) {
     // cap add creates the native project and copies the build into it; cap sync updates both.
-    run(capacitor, [exists(platform) ? "sync" : "add", platform], { cwd: shellDirectory });
+    // A new project gets its icons and splash screens from the logo (icons.mjs).
+    const created = !exists(platform);
+    run(capacitor, [created ? "add" : "sync", platform], { cwd: shellDirectory });
+    if (created) makeIcons(platform);
   }
   if (options.includes("--open")) {
     for (const platform of targets) run(capacitor, ["open", platform], { cwd: shellDirectory });

package/template/apps/capacitor/scripts/icons.mjs

@@ -0,0 +1,106 @@
+// The app's icons and splash screens, made from assets/logo.svg by Capacitor's asset tool:
+//
+//   node scripts/icons.mjs [android] [ios]
+//
+// build.mjs runs it when it creates a native project; run it again (pnpm icons) after changing
+// the art. Without a platform, it makes them for the native projects that exist. The tool runs
+// through npx at a fixed version, so the project installs nothing for it; it needs the network
+// the first time.
+import { spawnSync } from "node:child_process";
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const shellDirectory = join(import.meta.dirname, "..");
+const logoDirectory = join(import.meta.dirname, "../assets");
+const platforms = ["android", "ios"];
+
+// assets/logo.svg is the white mark on a full blue square, so the icon's background is the same
+// blue and the icon fills; the splash screens show it as a tile on the app's light and dark
+// backgrounds. Match these to your own art.
+const iconBackground = "#2563eb";
+const splashBackground = "#ffffff";
+const splashBackgroundDark = "#151515";
+
+/** The asset tool's arguments for one platform's icons and splash screens. */
+export function iconArguments(platform) {
+  return [
+    "--yes",
+    "@capacitor/assets@3.0.5",
+    "generate",
+    `--${platform}`,
+    "--assetPath",
+    relative(shellDirectory, logoDirectory),
+    "--iconBackgroundColor",
+    iconBackground,
+    "--iconBackgroundColorDark",
+    iconBackground,
+    "--splashBackgroundColor",
+    splashBackground,
+    "--splashBackgroundColorDark",
+    splashBackgroundDark,
+  ];
+}
+
+// Where each native project keeps its app icons.
+const iconDirectories = {
+  android: ["android/app/src/main/res", (name) => name.startsWith("mipmap")],
+  ios: ["ios/App/App/Assets.xcassets", (name) => name === "AppIcon.appiconset"],
+};
+
+/** When the platform's icon files last changed, so a run that wrote none shows. */
+function iconsChangedAt(platform) {
+  const [directory, isIconFolder] = iconDirectories[platform];
+  const root = join(shellDirectory, directory);
+  if (!existsSync(root)) return 0;
+  let latest = 0;
+  for (const folder of readdirSync(root).filter(isIconFolder)) {
+    for (const file of readdirSync(join(root, folder))) {
+      latest = Math.max(latest, statSync(join(root, folder, file)).mtimeMs);
+    }
+  }
+  return latest;
+}
+
+/**
+ * Makes one platform's icons and splash screens. When it cannot, as offline, the app keeps
+ * Capacitor's own: it says so and returns false, rather than stopping a build. The asset tool
+ * skips a platform without a native project and still succeeds, so success also means that it
+ * wrote the platform's icons.
+ */
+export function makeIcons(platform) {
+  if (!existsSync(join(shellDirectory, platform))) {
+    console.error(`The app has no ${platform} project yet: run pnpm ${platform} to create it.`);
+    return false;
+  }
+  const before = iconsChangedAt(platform);
+  const windows = process.platform === "win32";
+  const { status } = spawnSync(windows ? "npx.cmd" : "npx", iconArguments(platform), {
+    cwd: shellDirectory,
+    stdio: "inherit",
+    shell: windows,
+  });
+  if (status === 0 && iconsChangedAt(platform) > before) return true;
+  console.warn(
+    `The ${platform} app keeps Capacitor's default icon for now: run pnpm icons to make it from the logo.`,
+  );
+  return false;
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const named = process.argv.slice(2);
+  const unknown = named.find((arg) => !platforms.includes(arg));
+  if (unknown) {
+    console.error(`Unknown platform "${unknown}": choose android or ios.`);
+    process.exit(1);
+  }
+  const targets =
+    named.length > 0
+      ? named
+      : platforms.filter((platform) => existsSync(join(shellDirectory, platform)));
+  if (targets.length === 0) {
+    console.error("The app has no native project yet: run pnpm android or pnpm ios to create one.");
+    process.exit(1);
+  }
+  if (!targets.map(makeIcons).every(Boolean)) process.exit(1);
+}

package/template/apps/start/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/start",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/apps/start/public/.well-known/logo.svg

@@ -1 +1 @@
-<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><defs><style>.cls-1{fill:#2563eb;}.cls-2,.cls-3{fill:#fff;}.cls-2{fill-rule:evenodd;}</style></defs><rect class="cls-1" width="512" height="512"/><path class="cls-2" d="M364.36,283a359.51,359.51,0,0,0-43.5-10.18,364.29,364.29,0,0,1,5.24-55.17l30-15.13,20.83,5.63v34.6A43.79,43.79,0,0,0,364.36,283Zm-66.88-13.4a395.53,395.53,0,0,0-82.94,0,390.43,390.43,0,0,0-3-39L256,253l44.45-22.42A390.43,390.43,0,0,0,297.48,269.6Zm-106.32,3.22c-39.75,6.75-76,19.56-106.55,36.9a175.47,175.47,0,0,1-2.52-29.64,173.14,173.14,0,0,1,31-99.15l72.81,36.72a364.29,364.29,0,0,1,5.24,55.17Zm230.41,60.63A174.34,174.34,0,0,1,352.17,425c-17.72-36.5-28.9-80.53-31-128.34,37.9,6.89,72.13,19.67,100.42,36.78Zm-89.78,103.2a174.19,174.19,0,0,1-151.57,0c20-40.75,32.48-90.09,34.24-143.46a373.23,373.23,0,0,1,83.1,0C299.32,346.56,311.75,395.9,331.79,436.65ZM159.85,425a174.36,174.36,0,0,1-69.41-91.56c28.3-17.11,62.53-29.89,100.42-36.78-2.11,47.81-13.3,91.84-31,128.34Z"/><path class="cls-2" d="M256,58l173,84.17-33.81,17.05L280.05,128.07c-6.92-4.44-16-6.2-24-6.2-7.37,0-15.32,1.45-21.88,4.94s-11.85,9.19-11.85,16.9,5.42,13.48,11.85,16.9,14.51,4.94,21.88,4.94a54.52,54.52,0,0,0,9.29-.78l77.41,20.93L256,229.42,83,142.17,256,58Z"/><path class="cls-2" d="M256,130.18c8.43,0,15.9,2.18,20.52,5.55l140,37.84v72.75a29.68,29.68,0,0,0-18.51,0V192l-132.36-35.8a45,45,0,0,1-9.6,1c-14,0-25.42-6.05-25.42-13.53S242,130.18,256,130.18Z"/><circle class="cls-3" cx="407.23" cy="274.28" r="22.68"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="56" height="56" viewBox="0 0 56 56" role="img" aria-label="Clubedge Starter"><title>Clubedge Starter</title><g fill="#2563EB"><rect x="0" y="0" width="16" height="16" rx="3"/><rect x="20" y="0" width="16" height="16" rx="3"/><rect x="0" y="20" width="16" height="16" rx="3"/><rect x="0" y="40" width="16" height="16" rx="3"/><rect x="20" y="40" width="16" height="16" rx="3"/><circle cx="48" cy="8" r="8"/><circle cx="48" cy="48" r="8"/></g></svg>

package/template/apps/start/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="60" viewBox="0 0 60 60" role="img" aria-label="Clubedge Starter"><title>Clubedge Starter</title><g fill="#2563EB"><rect x="2" y="2" width="16" height="16" rx="3"/><rect x="22" y="2" width="16" height="16" rx="3"/><rect x="2" y="22" width="16" height="16" rx="3"/><rect x="2" y="42" width="16" height="16" rx="3"/><rect x="22" y="42" width="16" height="16" rx="3"/><circle cx="50" cy="10" r="8"/><circle cx="50" cy="50" r="8"/></g></svg>

package/template/apps/start/src/components/auth/auth-page.tsx

@@ -24,7 +24,7 @@ export function AuthPage({
             className="rounded-xl outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
             to="/"
           >
-            <ClubedgeMark className="size-12 rounded-xl" />
+            <ClubedgeMark className="size-12" />
           </Link>
           <div className="grid gap-1.5">
             <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>

package/template/apps/start/src/components/dashboard/dashboard-shell.tsx

@@ -176,7 +176,7 @@ function Title({ className }: { className?: string }) {
       href="#overview"
       className={cn("inline-flex min-w-0 items-center gap-2.5 font-semibold", className)}
     >
-      <ClubedgeMark alt="" className="size-6 shrink-0 rounded-md" />
+      <ClubedgeMark alt="" className="size-6 shrink-0" />
       <span className="truncate">{siteConfig.shortName}</span>
     </a>
   );

package/template/apps/start/src/routes/__root.tsx

@@ -30,7 +30,9 @@ export const Route = createRootRoute({
     ],
     links: [
       { rel: "stylesheet", href: appCss },
-      { rel: "icon", href: "/favicon.ico" },
+      { rel: "icon", href: "/favicon.ico", sizes: "48x48" },
+      { rel: "icon", href: "/favicon.svg", type: "image/svg+xml" },
+      { rel: "apple-touch-icon", href: "/apple-touch-icon.png" },
     ],
     scripts: [{ children: themeBootstrap }],
   }),

package/template/apps/start/src/routes/index.tsx

@@ -64,7 +64,7 @@ function LandingPage() {
             className="flex shrink-0 items-center gap-2.5 rounded-md outline-none focus-visible:ring-2 focus-visible:ring-ring"
             to="/"
           >
-            <ClubedgeMark alt="" className="size-9 rounded-xl" priority />
+            <ClubedgeMark alt="" className="size-9" priority />
             <span className="hidden text-sm font-semibold tracking-tight min-[380px]:inline">
               {siteConfig.name}
             </span>

package/template/apps/start/src/routes/login.tsx

@@ -71,7 +71,7 @@ function LoginPage() {
             className="rounded-xl outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
             to="/"
           >
-            <ClubedgeMark className="size-12 rounded-xl" />
+            <ClubedgeMark className="size-12" />
           </Link>
           <div className="grid gap-1.5">
             <h1 className="text-2xl font-semibold tracking-tight">

package/template/apps/vite/index.html

@@ -7,7 +7,9 @@
     <!-- vite.config.ts fills in the name and description from src/config/site.json. -->
     <title>%SITE_NAME%</title>
     <meta name="description" content="%SITE_DESCRIPTION%" />
-    <link rel="icon" href="/favicon.ico" />
+    <link rel="icon" href="/favicon.ico" sizes="48x48" />
+    <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
+    <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
     <!-- Applies the saved or preferred theme before first paint to avoid a flash. -->
     <script>
       try {

package/template/apps/vite/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/vite",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/apps/vite/public/.well-known/logo.svg

@@ -1 +1 @@
-<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><defs><style>.cls-1{fill:#2563eb;}.cls-2,.cls-3{fill:#fff;}.cls-2{fill-rule:evenodd;}</style></defs><rect class="cls-1" width="512" height="512"/><path class="cls-2" d="M364.36,283a359.51,359.51,0,0,0-43.5-10.18,364.29,364.29,0,0,1,5.24-55.17l30-15.13,20.83,5.63v34.6A43.79,43.79,0,0,0,364.36,283Zm-66.88-13.4a395.53,395.53,0,0,0-82.94,0,390.43,390.43,0,0,0-3-39L256,253l44.45-22.42A390.43,390.43,0,0,0,297.48,269.6Zm-106.32,3.22c-39.75,6.75-76,19.56-106.55,36.9a175.47,175.47,0,0,1-2.52-29.64,173.14,173.14,0,0,1,31-99.15l72.81,36.72a364.29,364.29,0,0,1,5.24,55.17Zm230.41,60.63A174.34,174.34,0,0,1,352.17,425c-17.72-36.5-28.9-80.53-31-128.34,37.9,6.89,72.13,19.67,100.42,36.78Zm-89.78,103.2a174.19,174.19,0,0,1-151.57,0c20-40.75,32.48-90.09,34.24-143.46a373.23,373.23,0,0,1,83.1,0C299.32,346.56,311.75,395.9,331.79,436.65ZM159.85,425a174.36,174.36,0,0,1-69.41-91.56c28.3-17.11,62.53-29.89,100.42-36.78-2.11,47.81-13.3,91.84-31,128.34Z"/><path class="cls-2" d="M256,58l173,84.17-33.81,17.05L280.05,128.07c-6.92-4.44-16-6.2-24-6.2-7.37,0-15.32,1.45-21.88,4.94s-11.85,9.19-11.85,16.9,5.42,13.48,11.85,16.9,14.51,4.94,21.88,4.94a54.52,54.52,0,0,0,9.29-.78l77.41,20.93L256,229.42,83,142.17,256,58Z"/><path class="cls-2" d="M256,130.18c8.43,0,15.9,2.18,20.52,5.55l140,37.84v72.75a29.68,29.68,0,0,0-18.51,0V192l-132.36-35.8a45,45,0,0,1-9.6,1c-14,0-25.42-6.05-25.42-13.53S242,130.18,256,130.18Z"/><circle class="cls-3" cx="407.23" cy="274.28" r="22.68"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="56" height="56" viewBox="0 0 56 56" role="img" aria-label="Clubedge Starter"><title>Clubedge Starter</title><g fill="#2563EB"><rect x="0" y="0" width="16" height="16" rx="3"/><rect x="20" y="0" width="16" height="16" rx="3"/><rect x="0" y="20" width="16" height="16" rx="3"/><rect x="0" y="40" width="16" height="16" rx="3"/><rect x="20" y="40" width="16" height="16" rx="3"/><circle cx="48" cy="8" r="8"/><circle cx="48" cy="48" r="8"/></g></svg>

package/template/apps/vite/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="60" viewBox="0 0 60 60" role="img" aria-label="Clubedge Starter"><title>Clubedge Starter</title><g fill="#2563EB"><rect x="2" y="2" width="16" height="16" rx="3"/><rect x="22" y="2" width="16" height="16" rx="3"/><rect x="2" y="22" width="16" height="16" rx="3"/><rect x="2" y="42" width="16" height="16" rx="3"/><rect x="22" y="42" width="16" height="16" rx="3"/><circle cx="50" cy="10" r="8"/><circle cx="50" cy="50" r="8"/></g></svg>

package/template/apps/vite/src/components/branding/clubedge-mark.tsx

@@ -1,3 +1,7 @@
+// Imported, so the build carries the logo in its own files: a folder whose name starts with a dot,
+// such as .well-known, never reaches the mobile app, since Android leaves those out of an app.
+import logo from "../../../public/.well-known/logo.svg";
+
 type ClubedgeMarkProps = {
   alt?: string;
   className?: string;
@@ -17,7 +21,7 @@ export function ClubedgeMark({
       fetchPriority={priority ? "high" : "auto"}
       height={512}
       loading={priority ? "eager" : "lazy"}
-      src="/.well-known/logo.svg"
+      src={logo}
       width={512}
     />
   );

package/template/apps/vite/src/components/dashboard/dashboard-shell.tsx

@@ -176,7 +176,7 @@ function Title({ className }: { className?: string }) {
       href="#overview"
       className={cn("inline-flex min-w-0 items-center gap-2.5 font-semibold", className)}
     >
-      <ClubedgeMark alt="" className="size-6 shrink-0 rounded-md" />
+      <ClubedgeMark alt="" className="size-6 shrink-0" />
       <span className="truncate">{siteConfig.shortName}</span>
     </a>
   );

package/template/apps/vite/src/routes/index.tsx

@@ -54,7 +54,7 @@ export function LandingPage() {
             className="flex shrink-0 items-center gap-2.5 rounded-md outline-none focus-visible:ring-2 focus-visible:ring-ring"
             to="/"
           >
-            <ClubedgeMark alt="" className="size-9 rounded-xl" priority />
+            <ClubedgeMark alt="" className="size-9" priority />
             <span className="hidden text-sm font-semibold tracking-tight min-[380px]:inline">
               {siteConfig.name}
             </span>

package/template/apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/web",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "scripts": {

package/template/apps/web/public/.well-known/logo.svg

@@ -1 +1 @@
-<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><defs><style>.cls-1{fill:#2563eb;}.cls-2,.cls-3{fill:#fff;}.cls-2{fill-rule:evenodd;}</style></defs><rect class="cls-1" width="512" height="512"/><path class="cls-2" d="M364.36,283a359.51,359.51,0,0,0-43.5-10.18,364.29,364.29,0,0,1,5.24-55.17l30-15.13,20.83,5.63v34.6A43.79,43.79,0,0,0,364.36,283Zm-66.88-13.4a395.53,395.53,0,0,0-82.94,0,390.43,390.43,0,0,0-3-39L256,253l44.45-22.42A390.43,390.43,0,0,0,297.48,269.6Zm-106.32,3.22c-39.75,6.75-76,19.56-106.55,36.9a175.47,175.47,0,0,1-2.52-29.64,173.14,173.14,0,0,1,31-99.15l72.81,36.72a364.29,364.29,0,0,1,5.24,55.17Zm230.41,60.63A174.34,174.34,0,0,1,352.17,425c-17.72-36.5-28.9-80.53-31-128.34,37.9,6.89,72.13,19.67,100.42,36.78Zm-89.78,103.2a174.19,174.19,0,0,1-151.57,0c20-40.75,32.48-90.09,34.24-143.46a373.23,373.23,0,0,1,83.1,0C299.32,346.56,311.75,395.9,331.79,436.65ZM159.85,425a174.36,174.36,0,0,1-69.41-91.56c28.3-17.11,62.53-29.89,100.42-36.78-2.11,47.81-13.3,91.84-31,128.34Z"/><path class="cls-2" d="M256,58l173,84.17-33.81,17.05L280.05,128.07c-6.92-4.44-16-6.2-24-6.2-7.37,0-15.32,1.45-21.88,4.94s-11.85,9.19-11.85,16.9,5.42,13.48,11.85,16.9,14.51,4.94,21.88,4.94a54.52,54.52,0,0,0,9.29-.78l77.41,20.93L256,229.42,83,142.17,256,58Z"/><path class="cls-2" d="M256,130.18c8.43,0,15.9,2.18,20.52,5.55l140,37.84v72.75a29.68,29.68,0,0,0-18.51,0V192l-132.36-35.8a45,45,0,0,1-9.6,1c-14,0-25.42-6.05-25.42-13.53S242,130.18,256,130.18Z"/><circle class="cls-3" cx="407.23" cy="274.28" r="22.68"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="56" height="56" viewBox="0 0 56 56" role="img" aria-label="Clubedge Starter"><title>Clubedge Starter</title><g fill="#2563EB"><rect x="0" y="0" width="16" height="16" rx="3"/><rect x="20" y="0" width="16" height="16" rx="3"/><rect x="0" y="20" width="16" height="16" rx="3"/><rect x="0" y="40" width="16" height="16" rx="3"/><rect x="20" y="40" width="16" height="16" rx="3"/><circle cx="48" cy="8" r="8"/><circle cx="48" cy="48" r="8"/></g></svg>

package/template/apps/web/src/app/dashboard/_components/dashboard-shell.tsx

@@ -180,7 +180,7 @@ function Title({ className }: { className?: string }) {
       href="#overview"
       className={cn("inline-flex min-w-0 items-center gap-2.5 font-semibold", className)}
     >
-      <ClubedgeMark alt="" className="size-6 shrink-0 rounded-md" />
+      <ClubedgeMark alt="" className="size-6 shrink-0" />
       <span className="truncate">{siteConfig.shortName}</span>
     </Link>
   );

package/template/apps/web/src/app/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="60" viewBox="0 0 60 60" role="img" aria-label="Clubedge Starter"><title>Clubedge Starter</title><g fill="#2563EB"><rect x="2" y="2" width="16" height="16" rx="3"/><rect x="22" y="2" width="16" height="16" rx="3"/><rect x="2" y="22" width="16" height="16" rx="3"/><rect x="2" y="42" width="16" height="16" rx="3"/><rect x="22" y="42" width="16" height="16" rx="3"/><circle cx="50" cy="10" r="8"/><circle cx="50" cy="50" r="8"/></g></svg>

package/template/apps/web/src/app/login/_components/auth-page.tsx

@@ -24,7 +24,7 @@ export function AuthPage({
             className="rounded-xl outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
             href="/"
           >
-            <ClubedgeMark className="size-12 rounded-xl" />
+            <ClubedgeMark className="size-12" />
           </Link>
           <div className="grid gap-1.5">
             <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>

package/template/apps/web/src/app/login/page.tsx

@@ -57,7 +57,7 @@ export default async function LoginPage({ searchParams }: LoginPageProps) {
             className="rounded-xl outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
             href="/"
           >
-            <ClubedgeMark className="size-12 rounded-xl" />
+            <ClubedgeMark className="size-12" />
           </Link>
           <div className="grid gap-1.5">
             <h1 className="text-2xl font-semibold tracking-tight">

package/template/apps/web/src/app/page.tsx

@@ -60,7 +60,7 @@ export default function LandingPage() {
             className="flex shrink-0 items-center gap-2.5 rounded-md outline-none focus-visible:ring-2 focus-visible:ring-ring"
             href="/"
           >
-            <ClubedgeMark alt="" className="size-9 rounded-xl" priority />
+            <ClubedgeMark alt="" className="size-9" priority />
             <span className="hidden text-sm font-semibold tracking-tight min-[380px]:inline">
               {siteConfig.name}
             </span>

package/template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clubedge-starter-v1",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.9.0",

package/template/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/auth-appwrite/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth-appwrite",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Appwrite provider for @clubedge/auth, run from the server with an API key and session cookies.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/auth-better-auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth-better-auth",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Better Auth adapter for @clubedge/auth, storing users and sessions in your own PostgreSQL.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/auth-firebase/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth-firebase",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Firebase Authentication provider for @clubedge/auth, run from the server with session cookies.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/auth-supabase/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth-supabase",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Supabase Auth adapter for @clubedge/auth.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/cache/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/cache",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/cache-redis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/cache-redis",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Redis rate limiter and cache for @clubedge/cache.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/contract/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/contract",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/core",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/db/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/db",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/email/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/email",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Email interface, console and in-memory providers, and message templates.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/email-resend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/email-resend",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Resend provider for @clubedge/email, through Resend's HTTP API.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/email-smtp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/email-smtp",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "SMTP provider for @clubedge/email, for any SMTP server.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/jobs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/jobs",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Background jobs interface: job definitions, a queue contract, and an in-memory queue.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/jobs-bullmq/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/jobs-bullmq",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "BullMQ provider for @clubedge/jobs: a job queue stored in Redis.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/jobs-inngest/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/jobs-inngest",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Inngest provider for @clubedge/jobs: jobs run by Inngest, which calls the app for each one.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/jobs-pg-boss/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/jobs-pg-boss",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "pg-boss provider for @clubedge/jobs: a job queue stored in the project's PostgreSQL.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/local-db/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/local-db",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "PostgreSQL for development without Docker: PGlite served over the PostgreSQL protocol.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/mobile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/mobile",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "The mobile app's native helpers, through Capacitor, and its own screens: the update notice and the demo.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/observability/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/observability",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Observability interface: error reports and spans for @clubedge/core's telemetry hooks, and an in-memory provider for tests.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/observability-otel/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/observability-otel",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "OpenTelemetry provider for @clubedge/observability: traces and error logs exported over OTLP to any collector.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/observability-sentry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/observability-sentry",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Sentry provider for @clubedge/observability: server and browser errors, traces, and source map uploads.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/payments/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/payments",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Provider-neutral payments: the PaymentProvider interface, billing logic, and subscription tables.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/payments-stripe/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/payments-stripe",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Stripe provider for @clubedge/payments: Checkout, the customer portal, and verified webhooks.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/storage-s3/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage-s3",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "S3-compatible adapter for @clubedge/storage.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/storage-supabase/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage-supabase",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Supabase Storage adapter for @clubedge/storage.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/ui",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template.lock.json

@@ -1,7 +1,7 @@
 {
   "repository": "Clubedge/clubedge-starter",
-  "ref": "v0.27.0",
-  "commit": "5f0e7e57131c4c56305d67edfd2e7366618d7b7c",
+  "ref": "v0.27.1",
+  "commit": "997d71d74775352d30dc2bb25017f46ef43f4fd8",
   "files": [
     ".dockerignore",
     ".env.example",
@@ -195,10 +195,12 @@
     "apps/api/src/tracing.ts",
     "apps/api/tsconfig.json",
     "apps/capacitor/.env.example",
+    "apps/capacitor/assets/logo.svg",
     "apps/capacitor/capacitor.config.ts",
     "apps/capacitor/clubedge.stack.json",
     "apps/capacitor/package.json",
     "apps/capacitor/scripts/build.mjs",
+    "apps/capacitor/scripts/icons.mjs",
     "apps/capacitor/tsconfig.json",
     "apps/start/.env.example",
     "apps/start/AGENTS.md",
@@ -208,7 +210,9 @@
     "apps/start/netlify.toml",
     "apps/start/package.json",
     "apps/start/public/.well-known/logo.svg",
+    "apps/start/public/apple-touch-icon.png",
     "apps/start/public/favicon.ico",
+    "apps/start/public/favicon.svg",
     "apps/start/scripts/check-env.ts",
     "apps/start/scripts/check-services.ts",
     "apps/start/src/components/auth/auth-form-controls.tsx",
@@ -320,7 +324,9 @@
     "apps/vite/index.html",
     "apps/vite/package.json",
     "apps/vite/public/.well-known/logo.svg",
+    "apps/vite/public/apple-touch-icon.png",
     "apps/vite/public/favicon.ico",
+    "apps/vite/public/favicon.svg",
     "apps/vite/server.mjs",
     "apps/vite/src/components/billing/billing-card.tsx",
     "apps/vite/src/components/branding/clubedge-mark.tsx",
@@ -382,6 +388,7 @@
     "apps/web/src/app/api/jobs/run/route.ts",
     "apps/web/src/app/api/ready/route.ts",
     "apps/web/src/app/api/webhooks/payments/route.ts",
+    "apps/web/src/app/apple-icon.png",
     "apps/web/src/app/auth/callback/route.ts",
     "apps/web/src/app/dashboard/_components/account-button.tsx",
     "apps/web/src/app/dashboard/_components/billing-actions.ts",
@@ -395,6 +402,7 @@
     "apps/web/src/app/error.tsx",
     "apps/web/src/app/favicon.ico",
     "apps/web/src/app/forgot-password/page.tsx",
+    "apps/web/src/app/icon.svg",
     "apps/web/src/app/layout.tsx",
     "apps/web/src/app/login/_components/auth-form-controls.tsx",
     "apps/web/src/app/login/_components/auth-page.tsx",