Centralize brand constants in @okcode/shared/brand

Create a single source of truth for the product name by introducing
packages/shared/src/brand.ts with APP_BASE_NAME and GIT_IDENTITY_NAME.
Re-export from apps/web/src/branding.ts and import in all workspace
packages instead of hardcoding "OK Code" strings.

- New: @okcode/shared/brand module with canonical constants
- Web: branding.ts re-exports APP_BASE_NAME from shared package
- Web: ChatHomeEmptyState uses APP_BASE_NAME instead of hardcoded string
- Desktop: main.ts imports APP_BASE_NAME for display name construction
- Desktop: electron-launcher.mjs extracts APP_BASE_NAME with sync comment
- Server: CheckpointStore uses GIT_IDENTITY_NAME for git author/committer
- Server: codexCliVersion uses APP_BASE_NAME in upgrade message
- Scripts: build-desktop-artifact uses APP_BASE_NAME for product name fallback

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: BunsDev

apps/desktop/scripts/electron-launcher.mjs

@@ -17,7 +17,9 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const isDevelopment = Boolean(process.env.VITE_DEV_SERVER_URL);
-const APP_DISPLAY_NAME = isDevelopment ? "OK Code (Dev)" : "OK Code";
+// Keep in sync with APP_BASE_NAME from @okcode/shared/brand
+const APP_BASE_NAME = "OK Code";
+const APP_DISPLAY_NAME = isDevelopment ? `${APP_BASE_NAME} (Dev)` : APP_BASE_NAME;
 const APP_BUNDLE_ID = "com.openknots.okcode";
 const LAUNCHER_VERSION = 1;
 

apps/desktop/src/main.ts

@@ -26,6 +26,7 @@ import type {
   PreviewTabsState,
 } from "@okcode/contracts";
 import { autoUpdater } from "electron-updater";
+import { APP_BASE_NAME } from "@okcode/shared/brand";
 
 import type { ContextMenuItem } from "@okcode/contracts";
 import { NetService } from "@okcode/shared/Net";
@@ -79,7 +80,7 @@ const STATE_DIR = Path.join(BASE_DIR, "userdata");
 const DESKTOP_SCHEME = "okcode";
 const ROOT_DIR = Path.resolve(__dirname, "../../..");
 const isDevelopment = Boolean(process.env.VITE_DEV_SERVER_URL);
-const APP_DISPLAY_NAME = isDevelopment ? "OK Code (Dev)" : "OK Code";
+const APP_DISPLAY_NAME = isDevelopment ? `${APP_BASE_NAME} (Dev)` : APP_BASE_NAME;
 const APP_USER_MODEL_ID = "com.openknots.okcode";
 const USER_DATA_DIR_NAME = isDevelopment ? "okcode-dev" : "okcode";
 const LEGACY_USER_DATA_DIR_NAME = isDevelopment ? "T3 Code (Dev)" : "T3 Code (Alpha)";

apps/server/src/checkpointing/Layers/CheckpointStore.ts

@@ -18,6 +18,7 @@ import { GitCommandError } from "../../git/Errors.ts";
 import { GitCore } from "../../git/Services/GitCore.ts";
 import { CheckpointStore, type CheckpointStoreShape } from "../Services/CheckpointStore.ts";
 import { CheckpointRef } from "@okcode/contracts";
+import { GIT_IDENTITY_NAME } from "@okcode/shared/brand";
 
 const makeCheckpointStore = Effect.gen(function* () {
   const fs = yield* FileSystem.FileSystem;
@@ -98,9 +99,9 @@ const makeCheckpointStore = Effect.gen(function* () {
             const commitEnv: NodeJS.ProcessEnv = {
               ...process.env,
               GIT_INDEX_FILE: tempIndexPath,
-              GIT_AUTHOR_NAME: "OK Code",
+              GIT_AUTHOR_NAME: GIT_IDENTITY_NAME,
               GIT_AUTHOR_EMAIL: "okcode@users.noreply.github.com",
-              GIT_COMMITTER_NAME: "OK Code",
+              GIT_COMMITTER_NAME: GIT_IDENTITY_NAME,
               GIT_COMMITTER_EMAIL: "okcode@users.noreply.github.com",
             };
 

apps/server/src/provider/codexCliVersion.ts

@@ -1,3 +1,5 @@
+import { APP_BASE_NAME } from "@okcode/shared/brand";
+
 const CODEX_VERSION_PATTERN = /\bv?(\d+\.\d+(?:\.\d+)?(?:-[0-9A-Za-z.-]+)?)\b/;
 
 export const MINIMUM_CODEX_CLI_VERSION = "0.37.0";
@@ -137,5 +139,5 @@ export function isCodexCliVersionSupported(version: string): boolean {
 
 export function formatCodexCliUpgradeMessage(version: string | null): string {
   const versionLabel = version ? `v${version}` : "the installed version";
-  return `Codex CLI ${versionLabel} is too old for OK Code. Upgrade to v${MINIMUM_CODEX_CLI_VERSION} or newer and restart OK Code.`;
+  return `Codex CLI ${versionLabel} is too old for ${APP_BASE_NAME}. Upgrade to v${MINIMUM_CODEX_CLI_VERSION} or newer and restart ${APP_BASE_NAME}.`;
 }

apps/web/src/branding.ts

@@ -1,4 +1,5 @@
-export const APP_BASE_NAME = "OK Code";
+export { APP_BASE_NAME } from "@okcode/shared/brand";
+
 export const APP_STAGE_LABEL = import.meta.env.DEV ? "Dev" : "";
 export const APP_DISPLAY_NAME = APP_STAGE_LABEL
   ? `${APP_BASE_NAME} (${APP_STAGE_LABEL})`

apps/web/src/components/ChatHomeEmptyState.tsx

@@ -15,7 +15,7 @@ import {
 import { useCallback, useMemo, useState } from "react";
 
 import { useAppSettings } from "../appSettings";
-import { APP_DISPLAY_NAME } from "../branding";
+import { APP_BASE_NAME, APP_DISPLAY_NAME } from "../branding";
 import { isElectron } from "../env";
 import { useHandleNewThread } from "../hooks/useHandleNewThread";
 import { serverConfigQueryOptions } from "../lib/serverReactQuery";
@@ -363,7 +363,7 @@ export function ChatHomeEmptyState() {
                         Launch a premium coding workspace with reliable agent sessions built in.
                       </h1>
                       <p className="mt-5 max-w-2xl text-sm leading-7 text-muted-foreground sm:text-base">
-                        OK Code keeps threads tied to real repositories, preserves provider state,
+                        {APP_BASE_NAME} keeps threads tied to real repositories, preserves provider state,
                         and gives your desktop a calmer control surface for deep, multi-session
                         work.
                       </p>

packages/shared/package.json

@@ -47,6 +47,10 @@
     "./skillCatalog": {
       "types": "./src/skillCatalog.ts",
       "import": "./src/skillCatalog.ts"
+    },
+    "./brand": {
+      "types": "./src/brand.ts",
+      "import": "./src/brand.ts"
     }
   },
   "scripts": {

packages/shared/src/brand.ts

@@ -0,0 +1,13 @@
+/**
+ * Canonical brand constants for the OK Code product.
+ *
+ * Import from `@okcode/shared/brand` in any workspace package.
+ * The web app's `branding.ts` re-exports these with Vite-specific additions
+ * (stage labels, build-time version injection).
+ */
+
+/** Base product name — use for display text that should not include a stage label. */
+export const APP_BASE_NAME = "OK Code";
+
+/** Git committer identity used by OK Code's internal operations (checkpoints, etc.). */
+export const GIT_IDENTITY_NAME = APP_BASE_NAME;

scripts/build-desktop-artifact.ts

@@ -8,6 +8,7 @@ import rootPackageJson from "../package.json" with { type: "json" };
 import desktopPackageJson from "../apps/desktop/package.json" with { type: "json" };
 import serverPackageJson from "../apps/server/package.json" with { type: "json" };
 
+import { APP_BASE_NAME } from "@okcode/shared/brand";
 import { BRAND_ASSET_PATHS } from "./lib/brand-assets.ts";
 import { resolveCatalogDependencies } from "./lib/resolve-catalog.ts";
 
@@ -736,7 +737,7 @@ const buildDesktopArtifact = Effect.fn("buildDesktopArtifact")(function* (
     build: yield* createBuildConfig(
       options.platform,
       options.target,
-      desktopPackageJson.productName ?? "OK Code",
+      desktopPackageJson.productName ?? APP_BASE_NAME,
       options.signed,
       options.signed && options.platform === "mac" ? macEntitlementsPlistAbsolutePath : undefined,
     ),