diff --git a/ATTRIBUTION.md b/ATTRIBUTION.md
index 2fdfe7ee..cb90c983 100644
--- a/ATTRIBUTION.md
+++ b/ATTRIBUTION.md
@@ -39,6 +39,7 @@ Generated-in-code assets are original and have no file to list:
 | docs/screenshots/sample-plate.png | SolidCraft contributors | screenshot of SolidCraft itself (`solidcraft --sample`) | MIT OR Apache-2.0 |
 | docs/screenshots/enclosure-demo-0.2.1.gif | SolidCraft contributors | original electronics enclosure screen recording of the actual SolidCraft 0.2.1 English desktop UI, generated with examples/demo/record_ui.sh and its original animated pointer overlay (4× playback) | MIT OR Apache-2.0 |
 | docs/screenshots/enclosure-demo-0.2.1.mp4 | SolidCraft contributors | original electronics enclosure screen recording of the actual SolidCraft 0.2.1 English desktop UI, generated with examples/demo/record_ui.sh and its original animated pointer overlay (4× playback) | MIT OR Apache-2.0 |
+| docs/book/src/og.png | SolidCraft contributors | original 1280 × 640 social preview card (the SolidCraft mark, name and tagline), served by the docs site for link previews | MIT OR Apache-2.0 |
 | docs/book/src/generated/sample-plate.png | SolidCraft contributors | copy of docs/screenshots/sample-plate.png made by `cargo xtask book` (gitignored) | MIT OR Apache-2.0 |
 | docs/book/src/generated/bracket.png | SolidCraft contributors | rendered by `cargo xtask book` (`solidcraft-cli snapshot examples/bracket.json`; gitignored) | MIT OR Apache-2.0 |
 | docs/book/src/generated/enclosure.png | SolidCraft contributors | rendered by `cargo xtask book` (`solidcraft-cli snapshot docs/book/scripts/enclosure.json`; gitignored) | MIT OR Apache-2.0 |
diff --git a/apps/solidcraft-web/index.html b/apps/solidcraft-web/index.html
index 42d371e8..b52538c2 100644
--- a/apps/solidcraft-web/index.html
+++ b/apps/solidcraft-web/index.html
@@ -4,6 +4,21 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
   <title>SolidCraft</title>
+  <meta name="description" content="Open-source parametric CAD built in Rust. Desktop, browser, and MCP for AI agents.">
+  <meta property="og:type" content="website">
+  <meta property="og:site_name" content="SolidCraft">
+  <meta property="og:title" content="SolidCraft: try it in your browser">
+  <meta property="og:description" content="Open-source parametric CAD built in Rust. Desktop, browser, and MCP for AI agents.">
+  <meta property="og:url" content="https://bherbruck.github.io/solidcraft/app/">
+  <meta property="og:image" content="https://bherbruck.github.io/solidcraft/og.png">
+  <meta property="og:image:width" content="1280">
+  <meta property="og:image:height" content="640">
+  <meta property="og:image:alt" content="SolidCraft: open-source parametric CAD built in Rust">
+  <meta name="twitter:card" content="summary_large_image">
+  <meta name="twitter:title" content="SolidCraft: try it in your browser">
+  <meta name="twitter:description" content="Open-source parametric CAD built in Rust. Desktop, browser, and MCP for AI agents.">
+  <meta name="twitter:image" content="https://bherbruck.github.io/solidcraft/og.png">
+  <meta name="twitter:image:alt" content="SolidCraft: open-source parametric CAD built in Rust">
   <link data-trunk rel="rust" data-bin="solidcraft-web" data-wasm-opt="z" data-weak-refs />
   <link data-trunk rel="copy-file" href="fonts/BIZUDPGothic-Regular.ttf" data-target-path="fonts" />
   <link data-trunk rel="copy-file" href="fonts/OFL.txt" data-target-path="fonts" />
diff --git a/docs/book/src/og.png b/docs/book/src/og.png
new file mode 100644
index 00000000..e4daefb5
Binary files /dev/null and b/docs/book/src/og.png differ
diff --git a/docs/book/theme/head.hbs b/docs/book/theme/head.hbs
new file mode 100644
index 00000000..87857aa9
--- /dev/null
+++ b/docs/book/theme/head.hbs
@@ -0,0 +1,15 @@
+{{!-- Link preview cards (OpenGraph / Twitter). The image is docs/book/src/og.png. --}}
+<meta property="og:type" content="website">
+<meta property="og:site_name" content="SolidCraft">
+<meta property="og:title" content="{{ title }}">
+<meta property="og:description" content="Open-source parametric CAD built in Rust. Desktop, browser, and MCP for AI agents.">
+<meta property="og:url" content="https://bherbruck.github.io/solidcraft/">
+<meta property="og:image" content="https://bherbruck.github.io/solidcraft/og.png">
+<meta property="og:image:width" content="1280">
+<meta property="og:image:height" content="640">
+<meta property="og:image:alt" content="SolidCraft: open-source parametric CAD built in Rust">
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{ title }}">
+<meta name="twitter:description" content="Open-source parametric CAD built in Rust. Desktop, browser, and MCP for AI agents.">
+<meta name="twitter:image" content="https://bherbruck.github.io/solidcraft/og.png">
+<meta name="twitter:image:alt" content="SolidCraft: open-source parametric CAD built in Rust">