Add version warning and canonical URLs to old versions

danharrin · danharrin · commit 249dff70d91e · 2025-06-02T16:26:35.000+01:00
diff --git a/docs/src/layouts/BaseLayout.astro b/docs/src/layouts/BaseLayout.astro
@@ -46,7 +46,7 @@ let nextPage = allLinks[linkIndex + 1]
 let section = packageNavigation.links?.find((item) => item.slug === currentSection) ?? null;
 
 pageTitle = pageTitle ?? buildTitle(title, packageNavigation);
-const canonicalURL = new URL(Astro.url.pathname, Astro.site);
+const canonicalURL = ((currentVersion !== '4.x') && (currentVersion !== '3.x')) ? new URL('docs/3.x', Astro.site) : new URL(Astro.url.pathname, Astro.site);
 ---
 
 <!DOCTYPE html>
@@ -172,8 +172,18 @@ const canonicalURL = new URL(Astro.url.pathname, Astro.site);
     </div>
     <div class="min-w-0 max-w-2xl flex-auto px-4 py-16 lg:max-w-none lg:pr-0 lg:pl-8 xl:pl-16 xl:pr-10">
         {(currentVersion === '4.x') && (
-            <Aside variant="info">
-                Filament v4 is currently in beta and is not stable. Please report any issues you encounter on <a href="https://github.com/filamentphp/filament/issues/new" target="_blank">GitHub</a>.
+            <Aside variant="warning">
+                <p><span class="font-medium">You are currently viewing the documentation for Filament 4.x</span>, which is currently in beta and is not stable. Please report any issues you encounter on <a href="https://github.com/filamentphp/filament/issues/new" target="_blank" class="font-medium underline">GitHub</a>.</p>
+
+                <p class="pt-3">Looking for the current stable version? Visit the <a href="/docs/3.x" class="font-medium underline">3.x documentation</a>.</p>
+            </Aside>
+        )}
+
+        {(currentVersion !== '4.x') && (currentVersion !== '3.x') && (
+            <Aside variant="warning">
+                <p><span class="font-medium">You are currently viewing the documentation for Filament {currentVersion}</span>, which is a previous version of Filament.</p>
+
+                <p class="pt-3">Looking for the current stable version? Visit the <a href="/docs/3.x" class="font-medium underline">3.x documentation</a>.</p>
             </Aside>
         )}
 
