feat(web): show app version in command palette (#1749)

* docs: update gcal and server guide

* feat(web): show app version in command palette

Adds a Version entry to the More section of the command palette so users
can see and copy their running version for bug reports. Also simplifies
BUILD_VERSION to drop the redundant timestamp prefix in git and CI
builds — tagged releases now show a clean semver (e.g. 0.5.4) instead
of a timestamp-prefixed string. Adds a versioning reference doc.

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

* feat(web): remove Donate and View Code from command palette

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: tyler-dane

docs/CI-CD/versioning.md

@@ -0,0 +1,38 @@
+# Versioning
+
+Compass uses two complementary version identifiers.
+
+## Semver tag (git)
+
+Format: `v{MAJOR}.{MINOR}.{PATCH}` — e.g. `v0.5.4`
+
+- Bumped automatically on every merge to `main` (patch) by `bump-and-tag.yml`
+- Minor/major bumps are manual: push a tag like `v0.6.0` directly
+- Used to tag Docker images on Docker Hub (`switchbacktech/compass-web:0.5.4`, `:0.5`, `:latest`)
+
+## BUILD_VERSION (frontend runtime)
+
+A string baked into the web bundle at build time by `packages/web/build.ts` and written to `build/web/version.json`. Used by `useVersionCheck` to detect when a newer deployment is available, and displayed in the command palette under **More → Version**.
+
+| Build context | Value |
+|---|---|
+| Tagged CI release | Semver without `v` — e.g. `0.5.4` (from `COMPASS_BUILD_REF`) |
+| Local dev (git available) | Short git SHA — e.g. `a1b2c3d` |
+| Self-hosted (no env set) | `{timestamp}-self-host` |
+
+### How it flows in CI
+
+1. `bump-and-tag.yml` pushes `v0.5.4`
+2. `publish-images.yml` fires, sets `COMPASS_BUILD_REF=0.5.4` as a Docker build arg
+3. `build.ts` reads `COMPASS_BUILD_REF`, sets `BUILD_VERSION = "0.5.4"`
+4. Bundle and `version.json` both contain `"0.5.4"`
+
+### Adding a new build context
+
+To inject a custom version (e.g. a self-hosted build with a known tag):
+
+```sh
+COMPASS_BUILD_REF=my-version bun run build
+```
+
+The `"self-host"` fallback (with timestamp prefix) is only used when git is unavailable **and** `COMPASS_BUILD_REF` is not set.

docs/README.md

@@ -42,6 +42,7 @@ Markdown files in this `docs/` directory are automatically mirrored to [docs.com
 - [Types And Validation](./development/types-and-validation.md)
 - [CI/CD](./ci-cd/README.md)
 - [CLI And Maintenance Commands](./ci-cd/cli-and-maintenance-commands.md)
+- [Versioning](./ci-cd/versioning.md)
 
 ## Feature Deep Dives
 

docs/self-hosting/google-calendar.md

@@ -153,6 +153,8 @@ Before you call continuous Google Calendar sync "working" on any self-host insta
 - Google watch registration succeeds
 - watch repair and refresh behavior holds up over time
 
+To confirm sync is live: create or edit one event directly in Google Calendar and confirm it appears in Compass without reconnecting Google. Then restart Compass and confirm the connection still works after restart.
+
 The repo has the code paths for Google watches and repair. The self-host Docker stack does not schedule watch renewal, so you need to verify and wire up maintenance separately before treating ongoing Google sync as dependable.
 
 ## What to read next

docs/self-hosting/server-guide.md

@@ -299,15 +299,7 @@ You want the Compass containers healthy, Caddy listening on public `80` and
 
 ## 7. Add Google Calendar (optional)
 
-If you want Google sign-in or Google Calendar watch notifications, see [Google Calendar — Public watch notifications](./google-calendar.md#public-watch-notifications). The short version:
-
-- add `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, and `TOKEN_GCAL_NOTIFICATION` to `~/compass/.env`
-- in your Google OAuth client, set the authorized JavaScript origin and redirect URI to `https://compass.example.com`
-- `./compass rebuild`
-
-Test Google connect, import, and webhook delivery on this install before relying on Google sync. Create or edit one event directly in Google Calendar and confirm it appears in Compass without reconnecting Google. Then restart Compass and confirm the connection still works.
-
-Long-running Google watch renewal is not scheduled by the self-host Docker stack. If you rely on ongoing Google sync, you still need to verify renewal on your server and wire up maintenance separately.
+See [Connect Google Calendar — Public watch notifications](./google-calendar.md#public-watch-notifications) for the full setup. Test Google connect, import, and webhook delivery on this install before relying on Google sync.
 
 ## Updating
 

packages/web/build.ts

@@ -29,7 +29,9 @@ function getBuildHash(): string {
     .trim();
 }
 
-const BUILD_VERSION = `${Date.now()}-${getBuildHash()}`;
+const buildHash = getBuildHash();
+const BUILD_VERSION =
+  buildHash === "self-host" ? `${Date.now()}-self-host` : buildHash;
 const OUTDIR = path.resolve(import.meta.dir, "../../build/web");
 
 const GOOGLE_CLIENT_ID = process.env.GOOGLE_CLIENT_ID;

packages/web/src/common/constants/more.cmd.constants.ts

@@ -9,13 +9,6 @@ export const moreCommandPaletteItems: Array<{
     heading: "More",
     id: "advanced",
     items: [
-      {
-        id: "code",
-        children: "View Code",
-        icon: "CodeBracketIcon",
-        href: "https://github.com/SwitchbackTech/compass",
-        target: "_blank",
-      },
       {
         id: "report-bug",
         children: "Report Bug",
@@ -31,11 +24,14 @@ export const moreCommandPaletteItems: Array<{
         target: "_blank",
       },
       {
-        id: "donate",
-        children: "Donate",
-        icon: "CreditCardIcon",
-        href: "https://buy.stripe.com/cNi8wQ6pE9gyejz6hZ9sk00",
-        target: "_blank",
+        id: "version",
+        children: `Version: ${typeof BUILD_VERSION === "string" ? BUILD_VERSION : "dev"}`,
+        icon: "InformationCircleIcon",
+        onClick: () => {
+          const v =
+            typeof BUILD_VERSION === "string" ? BUILD_VERSION : "dev";
+          void navigator.clipboard.writeText(v);
+        },
       },
     ],
   },