refactor(seo): rename to deco Studio with OG tags (#2701)

rafavalls · claude · web-flow · commit f8d2c705d5eb · 2026-03-13T17:13:10.000-03:00
* refactor(seo): rename MCP Mesh to Deco Studio, add OG/Twitter meta tags and image

- Rename product from "MCP Mesh" to "Deco Studio" across all SEO elements
- Add meta descriptions, OG tags, and Twitter cards to both mesh app and docs
- Wire up page descriptions from MDX frontmatter to HTML head
- Add og-image.png banner to both apps for social sharing previews
- Update site config with new tagline: "Hire specialized agents..."

Co-Authored-By: Claude Haiku 4.5 &lt;noreply@anthropic.com&gt;

* fix(fmt): break long description string for Biome formatting

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;

* fix(seo): lowercase 'deco Studio' branding

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;

* fix(seo): use relative og:image path to avoid localhost URL in docs

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;

* fix(seo): lowercase 'deco Studio' in MDX frontmatter descriptions

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;

---------

Co-authored-by: Claude Haiku 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/apps/docs/client/public/og-image.png b/apps/docs/client/public/og-image.png
diff --git a/apps/docs/client/src/components/ui/BaseHead.astro b/apps/docs/client/src/components/ui/BaseHead.astro
@@ -1,7 +1,19 @@
 ---
-const { title } = Astro.props;
-const formattedTitle = title ? `${title} - decoCMS` : "decoCMS";
+import { siteConfig } from "../../config/site";
+const { title, description } = Astro.props;
+const formattedTitle = title ? `${title} - deco Studio` : "deco Studio";
+const metaDescription = description || siteConfig.description;
+const ogImage = siteConfig.ogImage;
 ---
 
 <title>{formattedTitle}</title>
+<meta name="description" content={metaDescription} />
+<meta property="og:title" content={formattedTitle} />
+<meta property="og:description" content={metaDescription} />
+<meta property="og:site_name" content="deco Studio" />
+<meta property="og:image" content={ogImage} />
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content={formattedTitle} />
+<meta name="twitter:description" content={metaDescription} />
+<meta name="twitter:image" content={ogImage} />
 <link rel="icon" type="image/x-icon" href="/favicon.ico">
diff --git a/apps/docs/client/src/config/site.ts b/apps/docs/client/src/config/site.ts
@@ -1,8 +1,9 @@
 export const siteConfig = {
-  name: "Deco MCP Documentation",
-  description: "Documentation for Deco MCP server with tools and workflows",
+  name: "deco Studio Documentation",
+  description:
+    "Hire specialized agents, give them access to your tools, and let them deliver real projects — with planning, verification, and observability built in.",
   url: "https://your-domain.com",
-  ogImage: "https://your-domain.com/og.jpg",
+  ogImage: "/og-image.png",
   links: {
     github: "https://github.com/decocms/studio",
   },
diff --git a/apps/docs/client/src/content/2025-10-10/en/introduction.mdx b/apps/docs/client/src/content/2025-10-10/en/introduction.mdx
@@ -1,6 +1,6 @@
 ---
 title: Introduction
-description: Developer docs for the MCP Mesh and the deco CMS platform
+description: Developer docs for deco Studio and the deco CMS platform
 icon: Rocket
 ---
 
diff --git a/apps/docs/client/src/content/2025-10-10/en/mcp-mesh/deploy/kubernetes-helm-chart.mdx b/apps/docs/client/src/content/2025-10-10/en/mcp-mesh/deploy/kubernetes-helm-chart.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Kubernetes: Helm Chart"
-description: Deploy the MCP Mesh on Kubernetes using the Helm chart
+description: Deploy deco Studio on Kubernetes using the Helm chart
 icon: Rocket
 ---
 
diff --git a/apps/docs/client/src/content/2025-10-10/en/mcp-mesh/deploy/local-docker-compose.mdx b/apps/docs/client/src/content/2025-10-10/en/mcp-mesh/deploy/local-docker-compose.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Local: Docker Compose"
-description: Deploy the MCP Mesh locally using Docker Compose for testing and development
+description: Deploy deco Studio locally using Docker Compose for testing and development
 icon: Container
 ---
 
diff --git a/apps/docs/client/src/content/2025-10-10/en/mcp-mesh/overview.mdx b/apps/docs/client/src/content/2025-10-10/en/mcp-mesh/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: Overview
-description: What the MCP Mesh is, what it solves, and the main product surfaces
+description: What deco Studio is, what it solves, and the main product surfaces
 icon: Network
 ---
 
diff --git a/apps/docs/client/src/content/2025-10-10/pt-br/introduction.mdx b/apps/docs/client/src/content/2025-10-10/pt-br/introduction.mdx
@@ -1,6 +1,6 @@
 ---
 title: Introdução
-description: Documentação de desenvolvimento do MCP Mesh e da plataforma deco CMS
+description: Documentação de desenvolvimento do deco Studio e da plataforma deco CMS
 icon: Rocket
 ---
 
diff --git a/apps/docs/client/src/content/2025-10-10/pt-br/mcp-mesh/deploy/kubernetes-helm-chart.mdx b/apps/docs/client/src/content/2025-10-10/pt-br/mcp-mesh/deploy/kubernetes-helm-chart.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Kubernetes: Helm Chart"
-description: Deploy do MCP Mesh no Kubernetes usando o Helm chart
+description: Deploy do deco Studio no Kubernetes usando o Helm chart
 icon: Rocket
 ---
 
diff --git a/apps/docs/client/src/content/2025-10-10/pt-br/mcp-mesh/deploy/local-docker-compose.mdx b/apps/docs/client/src/content/2025-10-10/pt-br/mcp-mesh/deploy/local-docker-compose.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Local: Docker Compose"
-description: Deploy do MCP Mesh localmente usando Docker Compose para testes e desenvolvimento
+description: Deploy do deco Studio localmente usando Docker Compose para testes e desenvolvimento
 icon: Container
 ---
 
diff --git a/apps/docs/client/src/content/2025-10-10/pt-br/mcp-mesh/overview.mdx b/apps/docs/client/src/content/2025-10-10/pt-br/mcp-mesh/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: Visão geral
-description: O que é o MCP Mesh, o problema que ele resolve e as principais superfícies do produto
+description: O que é o deco Studio, o problema que ele resolve e as principais superfícies do produto
 icon: Network
 ---
 
diff --git a/apps/docs/client/src/layouts/DocsLayout.astro b/apps/docs/client/src/layouts/DocsLayout.astro
@@ -133,7 +133,7 @@ const editUrl = doc
       href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200"
       rel="stylesheet"
     />
-    <BaseHead title={title} />
+    <BaseHead title={title} description={doc?.data?.description} />
 
     <!-- Prevent flash of unstyled content -->
     <style>
diff --git a/apps/mesh/index.html b/apps/mesh/index.html
@@ -1,7 +1,16 @@
 <!DOCTYPE html>
 <html>
   <head>
-    <title>MCP Mesh</title>
+    <title>deco Studio</title>
+    <meta name="description" content="Hire specialized agents, give them access to your tools, and let them deliver real projects — with planning, verification, and observability built in." />
+    <meta property="og:title" content="deco Studio" />
+    <meta property="og:description" content="Hire specialized agents, give them access to your tools, and let them deliver real projects — with planning, verification, and observability built in." />
+    <meta property="og:image" content="/og-image.png" />
+    <meta property="og:site_name" content="deco Studio" />
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:title" content="deco Studio" />
+    <meta name="twitter:description" content="Hire specialized agents, give them access to your tools, and let them deliver real projects — with planning, verification, and observability built in." />
+    <meta name="twitter:image" content="/og-image.png" />
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
   </head>
   <body>
diff --git a/apps/mesh/public/og-image.png b/apps/mesh/public/og-image.png
