feat(config): add SEO headTags, metadata, and structured data by kunal-yelgate · Pull Request #318 · kmesh-net/website

kunal-yelgate · 2026-06-25T12:11:28Z

Adds global SEO configuration to docusaurus.config.js including Open Graph, Twitter Cards, and JSON-LD structured data.

Changes

headTags: Canonical link, meta description, OG tags, Twitter Card tags, Organization JSON-LD
themeConfig.metadata: Keywords, author, robots directives
image: Default social sharing card (img/kmesh-social-card.png)

Why

Pages currently lack any SEO metadata, causing poor search rankings and broken social previews.

Testing

Local build passes
All tags verified in page <head> via dev tools

Fixes #317

netlify · 2026-06-25T12:11:34Z

✅ Deploy Preview for kmesh-net ready!

Name	Link
🔨 Latest commit	`6a172ef`
🔍 Latest deploy log	https://app.netlify.com/projects/kmesh-net/deploys/6a43d0294f293c0008f5ae0a
😎 Deploy Preview	https://deploy-preview-318--kmesh-net.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

kmesh-bot · 2026-06-25T12:11:41Z

Welcome @kunal-yelgate! It looks like this is your first PR to kmesh-net/website 🎉

gemini-code-assist

Code Review

This pull request updates docusaurus.config.js to add a tagline, social sharing image, structured JSON-LD data, and various SEO metadata tags. The review feedback highlights a critical SEO issue where a hardcoded global canonical link in headTags would incorrectly point all subpages to the homepage. Additionally, it recommends moving global meta tags from headTags to themeConfig.metadata to leverage Docusaurus's built-in metadata management and allow page-specific overrides.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

gemini-code-assist · 2026-06-25T12:12:40Z

+  headTags: [
+    {
+      tagName: "link",
+      attributes: {
+        rel: "canonical",
+        href: "https://kmesh.net",
+      },
+    },
+    {
+      tagName: "meta",
+      attributes: {
+        name: "description",
+        content:
+          "Kmesh is a high-performance, sidecarless service mesh dataplane based on eBPF and programmable kernel for cloud-native applications.",
+      },
+    },
+    {
+      tagName: "meta",
+      attributes: {
+        property: "og:type",
+        content: "website",
+      },
+    },
+    {
+      tagName: "meta",
+      attributes: {
+        property: "og:site_name",
+        content: "Kmesh",
+      },
+    },
+    {
+      tagName: "meta",
+      attributes: {
+        name: "twitter:card",
+        content: "summary_large_image",
+      },
+    },
+    {
+      tagName: "meta",
+      attributes: {
+        name: "twitter:site",
+        content: "@Kmesh_net",
+      },
+    },


SEO & Docusaurus Best Practices Improvements

Remove Hardcoded Canonical Link: Docusaurus automatically generates the correct canonical URL (<link rel="canonical" href="..." />) for every page of your site using the global url and baseUrl configuration (which are already set). Hardcoding a global canonical link to https://kmesh.net in headTags will apply to all pages (e.g., documentation pages, blog posts), pointing their canonical URLs back to the homepage. This is a severe SEO issue as search engines will index only the homepage and ignore all other pages.

Move Meta Tags to themeConfig.metadata: Using headTags injects these tags statically into every page, which can result in duplicate tags (e.g., multiple <meta name="description"> tags) when individual pages or blog posts define their own descriptions or custom metadata. Defining them in themeConfig.metadata allows Docusaurus to manage them properly and lets individual pages override them seamlessly.

Let's remove the canonical link and move the meta tags to themeConfig.metadata.

Suggested change

headTags: [

{

tagName: "link",

attributes: {

rel: "canonical",

href: "https://kmesh.net",

},

},

{

tagName: "meta",

attributes: {

name: "description",

content:

"Kmesh is a high-performance, sidecarless service mesh dataplane based on eBPF and programmable kernel for cloud-native applications.",

},

},

{

tagName: "meta",

attributes: {

property: "og:type",

content: "website",

},

},

{

tagName: "meta",

attributes: {

property: "og:site_name",

content: "Kmesh",

},

},

{

tagName: "meta",

attributes: {

name: "twitter:card",

content: "summary_large_image",

},

},

{

tagName: "meta",

attributes: {

name: "twitter:site",

content: "@Kmesh_net",

},

},

headTags: [

gemini-code-assist · 2026-06-25T12:12:40Z

+      metadata: [
+        {
+          name: "keywords",
+          content:
+            "Kmesh, service mesh, eBPF, dataplane, Kubernetes, sidecarless, cloud-native, CNCF, high-performance networking",
+        },
+        {
+          name: "author",
+          content: "Kmesh Community",
+        },
+        {
+          name: "robots",
+          content: "index, follow",
+        },
+      ],


Move the global meta tags (description, og:type, og:site_name, twitter:card, and twitter:site) from headTags to themeConfig.metadata so that Docusaurus can manage them properly and allow page-specific overrides.

metadata: [ { name: "description", content: "Kmesh is a high-performance, sidecarless service mesh dataplane based on eBPF and programmable kernel for cloud-native applications.", }, { property: "og:type", content: "website", }, { property: "og:site_name", content: "Kmesh", }, { name: "twitter:card", content: "summary_large_image", }, { name: "twitter:site", content: "@Kmesh_net", }, { name: "keywords", content: "Kmesh, service mesh, eBPF, dataplane, Kubernetes, sidecarless, cloud-native, CNCF, high-performance networking", }, { name: "author", content: "Kmesh Community", }, { name: "robots", content: "index, follow", }, ],

yashisrani · 2026-06-29T17:10:32Z

@kunal-yelgate please fix this build errors

…urus config Signed-off-by: kunal_yelgate <kunalyelgatew@gmail.com>

Signed-off-by: kunal_yelgate <kunalyelgatew@gmail.com>

kunal-yelgate · 2026-06-30T14:31:31Z

Hey @yashisrani, I fixed the build error. The project now builds successfully for both the default locale and the zh locale:

[SUCCESS] Generated static files in "build".
[INFO] [zh] Creating an optimized production build...
[SUCCESS] Generated static files in "build\zh".
[INFO] Use `npm run serve` command to test your build locally.

The build is completing successfully now.

jayesh9747 · 2026-07-04T10:57:12Z

/lgtm

jayesh9747 · 2026-07-04T10:59:15Z

/lgtm

kmesh-bot · 2026-07-04T10:59:40Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: jayesh9747

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

~~OWNERS~~ [jayesh9747]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

kmesh-bot requested review from LiZhenCheng9527 and jayesh9747 June 25, 2026 12:11

kmesh-bot added the size/M label Jun 25, 2026

kunal-yelgate force-pushed the feat/seo-metadata-docusaurus branch from a3fa9de to a397405 Compare June 25, 2026 12:12

gemini-code-assist Bot reviewed Jun 25, 2026

View reviewed changes

kunal-yelgate added 3 commits June 30, 2026 19:47

add metadata, OpenGraph, Twitter cards, and structured data to Docusa…

dda5bfb

…urus config Signed-off-by: kunal_yelgate <kunalyelgatew@gmail.com>

fix: move image field to themeConfig to resolve build error

09b3297

Signed-off-by: kunal_yelgate <kunalyelgatew@gmail.com>

fix: implement PR review feedback for SEO metadata

6a172ef

Signed-off-by: kunal_yelgate <kunalyelgatew@gmail.com>

kunal-yelgate force-pushed the feat/seo-metadata-docusaurus branch from a9dafd1 to 6a172ef Compare June 30, 2026 14:18

kmesh-bot assigned jayesh9747 Jul 4, 2026

kmesh-bot added the lgtm label Jul 4, 2026

jayesh9747 added this pull request to the merge queue Jul 4, 2026

jayesh9747 approved these changes Jul 4, 2026

View reviewed changes

kmesh-bot added the approved label Jul 4, 2026

github-merge-queue Bot removed this pull request from the merge queue due to no response for status checks Jul 4, 2026

kmesh-bot merged commit 0b5da86 into kmesh-net:main Jul 4, 2026
12 checks passed

kunal-yelgate deleted the feat/seo-metadata-docusaurus branch July 4, 2026 12:14

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(config): add SEO headTags, metadata, and structured data#318

feat(config): add SEO headTags, metadata, and structured data#318
kmesh-bot merged 3 commits into
kmesh-net:mainfrom
kunal-yelgate:feat/seo-metadata-docusaurus

kunal-yelgate commented Jun 25, 2026

Uh oh!

netlify Bot commented Jun 25, 2026 •

edited

Loading

Uh oh!

kmesh-bot commented Jun 25, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

gemini-code-assist Bot Jun 25, 2026

Uh oh!

gemini-code-assist Bot Jun 25, 2026

Uh oh!

yashisrani commented Jun 29, 2026

Uh oh!

kunal-yelgate commented Jun 30, 2026

Uh oh!

jayesh9747 commented Jul 4, 2026

Uh oh!

jayesh9747 commented Jul 4, 2026

Uh oh!

kmesh-bot commented Jul 4, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

kunal-yelgate commented Jun 25, 2026

Changes

Why

Testing

Uh oh!

netlify Bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for kmesh-net ready!

Uh oh!

kmesh-bot commented Jun 25, 2026

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist Bot Jun 25, 2026

Choose a reason for hiding this comment

SEO & Docusaurus Best Practices Improvements

Uh oh!

gemini-code-assist Bot Jun 25, 2026

Choose a reason for hiding this comment

Uh oh!

yashisrani commented Jun 29, 2026

Uh oh!

kunal-yelgate commented Jun 30, 2026

Uh oh!

jayesh9747 commented Jul 4, 2026

Uh oh!

jayesh9747 commented Jul 4, 2026

Uh oh!

kmesh-bot commented Jul 4, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

netlify Bot commented Jun 25, 2026 •

edited

Loading