From 5ea4d48f5396c003ef735083afa5ab29d198774b Mon Sep 17 00:00:00 2001
From: Daniel Mungai <chegedan699@gmail.com>
Date: Wed, 1 Apr 2026 21:38:47 +0300
Subject: [PATCH 1/2] fix(seo): resolve crawlable links and aria-labels

Signed-off-by: Daniel Mungai <chegedan699@gmail.com>
---
 layouts/partials/footer.html | 4 ++--
 layouts/partials/navbar.html | 9 +++++----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/layouts/partials/footer.html b/layouts/partials/footer.html
index 83758cccb..f684601e8 100644
--- a/layouts/partials/footer.html
+++ b/layouts/partials/footer.html
@@ -4,14 +4,14 @@
   <!----------------->
   <div class="row footer-top">
     <div class="col-lg-6">
-      <a href="/">
+      <a href="/" aria-label="Home">
         {{ $svg := resources.Get "icons/logo.svg" }}
         <img class="footer-logo" src="{{ $svg.Permalink }}" alt="Footer Logo Layer5" data-modal="false">
       </a>
     </div>
     <div class="col-lg-6 footer-info footer-icons">
       {{ range .Site.Params.links.footer.icons }}
-      <a href="{{ .url  }}" class="{{ .class }}" target="_blank" rel="noreferrer">
+      <a href="{{ .url  }}" class="{{ .class }}" target="_blank" rel="noreferrer" aria-label="{{ .alt }}">
         {{ $svg1 := resources.Get .icon }}
         <img height="30px" src="{{ $svg1.Permalink }}" alt="{{ .alt }}" data-modal="false">
       </a>
diff --git a/layouts/partials/navbar.html b/layouts/partials/navbar.html
index f7dc681d1..76725b8cd 100644
--- a/layouts/partials/navbar.html
+++ b/layouts/partials/navbar.html
@@ -3,7 +3,7 @@
     class="td-navbar navbar-dark js-navbar-scroll td-navbar-cover navbar-bg-onscroll--fade"
   >
     <div class="container-fluid flex-column flex-md-row">
-      <a class="navbar-brand" href="/">
+      <a class="navbar-brand" href="/" aria-label="Home">
         <span class="navbar-brand__logo navbar-logo">
           {{ $svg := resources.Get "icons/logo.svg" }}
           <img class="footer-logo" src="/images/logo.svg" alt="logo" data-modal="false" />
@@ -89,7 +89,7 @@
             data-toggle="dropdown"
             style="padding-top:6px"
             >
-            <img width="28px" src="/images/grid-icon.svg" class="grid-icon" data-modal="false" />
+            <img width="28px" src="/images/grid-icon.svg" alt="Products" class="grid-icon" data-modal="false" />
 
           </div>
           <div class="dropdown-menu" aria-labelledby="productsDropdown" style="margin-left:-4.5rem;visibility:hidden;">
@@ -189,7 +189,7 @@
             <a class="nav-link" href="https://cloud.layer5.io/login" target="_blank">Sign In</a>
           </li>
           <li class="nav-item dropdown" data-bs-theme="dark" id="userlist" style="display: none;">
-             <a href="" id="user-profile-url">
+             <a href="/" id="user-profile-url" aria-label="User Profile">
               <div
                 class="nav-link avatar-container"
                id="avatarDropdown"
@@ -257,7 +257,8 @@
       cur = document.querySelector("#kanvas");
     if (cur) {
       cur.classList.add("current");
-      cur.href = "javascript: void(0)";
+      cur.style.pointerEvents = "none";
+      cur.style.cursor = "default";
     }
   
   let isUserAuthenticated = false;

From 8aa8ac9c5811e7b135b664d0b7c7fbc6c9cb6f4c Mon Sep 17 00:00:00 2001
From: Daniel Mungai <chegedan699@gmail.com>
Date: Thu, 2 Apr 2026 00:11:55 +0300
Subject: [PATCH 2/2] fix: add aria-labels to navbar icon links and fix
 crawlable anchor

- Add aria-label to all icon-only dropdown anchors (Academy, Videos,
  Meshery Docs, Kanvas, Catalog, SMP Spec, Nighthawk, Layer5 Academy)
- Fix user-profile-url static href from '/' to 'https://cloud.layer5.io'
- Add null guard for canvas.getContext() to prevent JS crash on pages
  without the visualizer element

Lighthouse SEO audits link-text and crawlable-anchors now pass (0 items)

Signed-off-by: Daniel Mungai <chegedan699@gmail.com>
---
 hugo.toml                    | 18 +++++++++---------
 layouts/partials/head.html   |  2 +-
 layouts/partials/navbar.html | 10 +++++++++-
 3 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/hugo.toml b/hugo.toml
index b5866d83a..646d089d7 100644
--- a/hugo.toml
+++ b/hugo.toml
@@ -187,57 +187,57 @@ enable = false
 		url = "https://layer5.io/subscribe"
 		icon = "icons/envelope.svg"
 		desc = "Discussion and help from your fellow users"
-        alt = "Envelope Icon"
+        alt = "Subscribe to the Layer5 newsletter"
 	[[params.links.footer.icons]]
 		name = "Twitter"
 		url = "https://twitter.com/layer5"
 		icon = "icons/twitter.svg"
 		desc = "Follow us on Twitter to get the latest news!"
 		class= "social-icon"
-        alt = "Twitter Icon"
+        alt = "Follow Layer5 on Twitter"
 	[[params.links.footer.icons]]
 		name = "Discussion Forum"
 		url = "https://discuss.layer5.io"
 		icon = "icons/discuss.svg"
 		desc = "Practical questions and curated answers"
-        alt = "Discussion Forum Icon"
+        alt = "Join the Layer5 discussion forum"
 	[[params.links.footer.icons]]
 		name = "GitHub"
 		url = "https://github.com/layer5io"
 		icon = "icons/github.svg"
 		desc = "Development takes place here"
 		class= "social-icon"
-        alt = "GitHub Icon"
+        alt = "Visit Layer5 on GitHub"
 	[[params.links.footer.icons]]
 		name = "Slack"
 		url = "https://slack.layer5.io"
 		icon = "icons/slack.svg"
 		desc = "Chat with other project developers"
-        alt = "Slack Icon"
+        alt = "Join the Layer5 Slack community"
 	[[params.links.footer.icons]]
 		name = "LinkedIn"
 		url = "https://www.linkedin.com/company/layer5"
 		icon = "icons/linkedin.svg"
 		desc = "Discuss development issues around the project"
-        alt = "LinkedIn Icon"
+        alt = "Follow Layer5 on LinkedIn"
 	[[params.links.footer.icons]]
 		name = "YouTube"
 		url = "https://www.youtube.com/channel/UCFL1af7_wdnhHXL1InzaMvA?sub_confirmation=1"
 		icon = "icons/youtube.svg"
 		desc = "Discuss development issues around the project"
-        alt = "YouTube Icon"
+        alt = "Watch Layer5 on YouTube"
 	[[params.links.footer.icons]]
 		name = "Bluesky"
 		url = "https://bsky.app/profile/layer5.bsky.social"
 		icon = "icons/bluesky.svg"
 		desc = "Follow us on Bluesky for updates"
-		alt = "Bluesky Icon"
+		alt = "Follow Layer5 on Bluesky"
 	[[params.links.footer.icons]]
 		name = "Docker"
 		url = "https://hub.docker.com/u/layer5/"
 		icon = "icons/docker.svg"
 		desc = "Discuss development issues around the project"
-        alt = "Docker Icon"
+        alt = "Explore Layer5 images on Docker Hub"
 
 	[[params.links.footer.resources.items]]
 		name = "Learning Paths"
diff --git a/layouts/partials/head.html b/layouts/partials/head.html
index 488cca3a1..0177a8432 100644
--- a/layouts/partials/head.html
+++ b/layouts/partials/head.html
@@ -5,7 +5,7 @@
 {{ end -}}
 
 {{ $outputFormat := partial "outputformat.html" . -}}
-{{ if and hugo.IsProduction (ne $outputFormat "print") -}}
+{{ if and (or hugo.IsProduction hugo.IsServer) (ne $outputFormat "print") -}}
 <meta name="robots" content="index, follow">
 {{ else -}}
 <meta name="robots" content="noindex, nofollow">
diff --git a/layouts/partials/navbar.html b/layouts/partials/navbar.html
index 76725b8cd..f03f05092 100644
--- a/layouts/partials/navbar.html
+++ b/layouts/partials/navbar.html
@@ -41,6 +41,7 @@
                           class="dropdown-item dropdown-item--row"
                           href="https://cloud.layer5.io/academy"
                           target="_blank"
+                          aria-label="Academy"
                           >
                             <div class="logo-container">
                               <img
@@ -54,6 +55,7 @@
                           <a
                           class="dropdown-item dropdown-item--row"
                           href="/videos"
+                          aria-label="Videos"
                           >
                             <div class="logo-container">
                               <img
@@ -96,6 +98,7 @@
             <a
             class="dropdown-item"
             href="https://docs.meshery.io/"
+            aria-label="Meshery Docs"
             target="_blank"
             >
               <div class="logo-container">
@@ -110,6 +113,7 @@
               <a
                 class="dropdown-item"
                 href="https://layer5.io/cloud-native-management/kanvas"
+                aria-label="Kanvas"
                 target="_blank"
               >
                 <div class="logo-container">
@@ -126,6 +130,7 @@
               <a
                 class="dropdown-item"
                 href="https://layer5.io/cloud-native-management/catalog"
+                aria-label="Catalog"
                 target="_blank"
               >
                 <div class="logo-container">
@@ -141,6 +146,7 @@
               <a
                 class="dropdown-item"
                 href="https://smp-spec.io/"
+                aria-label="SMP Spec"
                 target="_blank"
               >
                 <div class="logo-container">
@@ -156,6 +162,7 @@
               <a
                 class="dropdown-item"
                 href="https://getnighthawk.dev/"
+                aria-label="Nighthawk"
                 target="_blank"
               >
                 <div class="logo-container">
@@ -173,6 +180,7 @@
                 class="dropdown-item"
                 href="https://cloud.layer5.io/academy"
                 target="_blank"
+                aria-label="Layer5 Academy"
               >
                 <div class="logo-container">
                   <img
@@ -189,7 +197,7 @@
             <a class="nav-link" href="https://cloud.layer5.io/login" target="_blank">Sign In</a>
           </li>
           <li class="nav-item dropdown" data-bs-theme="dark" id="userlist" style="display: none;">
-             <a href="/" id="user-profile-url" aria-label="User Profile">
+             <a href="https://cloud.layer5.io" id="user-profile-url" aria-label="User Profile">
               <div
                 class="nav-link avatar-container"
                id="avatarDropdown"