docs: refresh entity with an illustrated beet mascot

README.md

@@ -2,7 +2,7 @@
 
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="docs/public/logo-dark.svg">
-  <img src="docs/public/logo-light.svg" alt="entity" width="170" height="114" />
+  <img src="docs/public/logo-light.svg" alt="entity logo" width="128" height="128" />
 </picture>
 
 # entity

docs/.vitepress/config.ts

@@ -139,7 +139,7 @@ export default defineConfig({
   },
 
   themeConfig: {
-    logo: { light: "/logo-light.svg", dark: "/logo-dark.svg" },
+    logo: { light: "/logo-light.svg", dark: "/logo-dark.svg", alt: "entity logo" },
 
     nav: [
       // The guide is organised by the four Diátaxis modes; the dropdown links
@@ -220,7 +220,7 @@ export default defineConfig({
   },
 
   head: [
-    ["link", { rel: "icon", type: "image/svg+xml", href: `${BASE}logo.svg` }],
+    ["link", { rel: "icon", type: "image/svg+xml", href: `${BASE}favicon.svg` }],
     ["meta", { name: "author", content: "Benoit TRAVERS" }],
     ["meta", { name: "robots", content: "index, follow" }],
     ["meta", { name: "application-name", content: "entity" }],
@@ -236,16 +236,10 @@ export default defineConfig({
     ["meta", { property: "og:type", content: "website" }],
     ["meta", { property: "og:site_name", content: "entity" }],
     ["meta", { property: "og:locale", content: "en_US" }],
-    // The 1280x640 social card, on the same template as the other btravstack
-    // packages. SVG is not a valid og:image: X, Slack, LinkedIn and Discord all
-    // refuse to render one, which is why pointing this at the logo produced no
-    // preview at all rather than a small one.
     ["meta", { property: "og:image", content: `${SITE_URL}og-entity.png` }],
     ["meta", { property: "og:image:type", content: "image/png" }],
-    // The card's true size. The sibling sites declare 1200x630 (the size the OG
-    // docs recommend) while shipping a 1280x640 file; these are measured.
-    ["meta", { property: "og:image:width", content: "1280" }],
-    ["meta", { property: "og:image:height", content: "640" }],
+    ["meta", { property: "og:image:width", content: "1200" }],
+    ["meta", { property: "og:image:height", content: "630" }],
     [
       "meta",
       {

docs/branding/README.md

@@ -0,0 +1,22 @@
+# entity branding
+
+The illustrated mascot is a pink beet at the bottom of an identity-card photo,
+with its hands resting across the lower frame as if ready to climb out. It belongs
+to the shared btravstack beet family. Its editable source is
+[`scripts/generate-brand.mjs`](https://github.com/btravstack/btravstack.github.io/blob/main/scripts/generate-brand.mjs)
+in the website repository. Regenerate there, then copy the project assets from
+`apps/website/public/logos/` into this repository's `docs/public/`:
+
+- `entity-light.svg` → `logo-light.svg` and `logo.svg` (the default).
+- `entity-dark.svg` → `logo-dark.svg`.
+- `entity-mono.svg` → `logo-mono.svg` (grayscale print, retaining the shading).
+- `entity-favicon.svg` → `favicon.svg`.
+
+The README and documentation navigation and hero use the light/dark pair.
+The favicon uses a simplified mascot portrait for legibility at small sizes.
+The social preview is `og-entity.png`, a 1200 × 630 PNG using the same mark.
+Its editable source is the website's
+[`branding/social-card.html`](https://github.com/btravstack/btravstack.github.io/blob/main/branding/social-card.html),
+rendered with `?project=entity`.
+Keep its dimensions in the VitePress metadata in sync when replacing it.
+Assets are committed locally; rendering never fetches branding from another site.

docs/index.md

@@ -10,7 +10,7 @@ hero:
   image:
     light: /logo-light.svg
     dark: /logo-dark.svg
-    alt: entity
+    alt: entity logo
   actions:
     - theme: brand
       text: Get Started