USE v3 DOCS AS DEFAULT

Author: danharrin

docs/src/components/Navigation.astro

@@ -2,10 +2,10 @@
 import { Icon } from 'astro-icon/components';
 
 let segments = Astro.url.pathname.match(/\/([0-9]*\.x)\/([a-z\-\_]*)\//) || [
-  '/4.x/introduction/overview/',
-  '4.x',
-  'introduction',
-  'overview',
+  '/3.x/panels/installation/',
+  '3.x',
+  'panels',
+  'installation',
 ]
 
 const { navigation } = Astro.props

docs/src/components/VersionSelector.astro

@@ -1,7 +1,7 @@
 ---
 import navigation from '../navigation.json'
 
-let segments = Astro.url.pathname.match(/\/([0-9]*\.x)\/([a-z\-\_]*)\/([a-z\-\_]*)\/([a-z\-\_]*)/) || ["/4.x/introduction/overview/", "4.x", "introduction", "overview"];
+let segments = Astro.url.pathname.match(/\/([0-9]*\.x)\/([a-z\-\_]*)\/([a-z\-\_]*)\/([a-z\-\_]*)/) || ["/3.x/panels/installation/", "3.x", "panels", "installation"];
 let currentVersion = segments[1].replaceAll("/", "");
 let currentSection = segments[2].replaceAll("/", "");
 let currentPage = (segments[3] ?? null)?.replaceAll("/", "");
@@ -46,7 +46,7 @@ const versions = navigation.map((version) => {
         aria-label="Open version options"
     >
       <span class="hidden sm:block">Version&nbsp;</span>
-      <span id="current-version" class="font-bold">{currentVersion}</span>
+      <span id="current-version" class="font-bold">{currentVersion} {(currentVersion === '4.x') ? 'beta' : ''}</span>
     </button>
 
     <div
@@ -59,7 +59,7 @@ const versions = navigation.map((version) => {
         {versions.map((version) => (
           <a
             href={version.href}
-            class="flex justify-center items-center rounded-[0.5rem] py-1 px-3 w-full hover:bg-gray-100 hover:dark:bg-gray-900/40 transition duration-200"
+            class="flex justify-start items-center rounded-[0.5rem] py-1 px-3 w-full hover:bg-gray-100 hover:dark:bg-gray-900/40 transition duration-200"
             class:list={[
                 {
                     'text-primary-500 hover:text-primary-500 hover:dark:text-primary-500': version.version === currentVersion,
@@ -70,7 +70,7 @@ const versions = navigation.map((version) => {
             ]}
           >
             <span>Version&nbsp;</span>
-            <span>{version.version}</span>
+            <span>{version.version} {(version.version === '4.x') ? 'beta' : ''}</span>
           </a>
         ))}
     </div>

docs/src/layouts/BaseLayout.astro

@@ -1,5 +1,6 @@
 ---
 import { collectHeadings, getAllLinks } from "src/lib/helpers";
+import Aside from "@components/Aside.astro";
 import Navigation from "@components/Navigation.astro";
 import Footer from "@components/Footer.astro";
 import Header from "@components/Header.astro";
@@ -28,7 +29,7 @@ let isHomePage = Astro.url.pathname === "/docs";
 
 let tableOfContents = headings.length > 0 ? collectHeadings(headings) : [];
 
-let segments = Astro.url.pathname.match(/\/([0-9]*\.x)\/([a-z\-\_]*)\/([a-z\-\_]*)/) || ["/4.x/introduction/overview/", "4.x", "introduction", "overview"];
+let segments = Astro.url.pathname.match(/\/([0-9]*\.x)\/([a-z\-\_]*)\/([a-z\-\_]*)/) || ["/4.x/introduction/overview/", "3.x", "panels", "installation"];
 
 let currentVersion = segments[1].replaceAll("/", "");
 let currentPackage = segments[2].replaceAll("/", "");
@@ -170,6 +171,12 @@ const canonicalURL = new URL(Astro.url.pathname, Astro.site);
         </div>
     </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>
+        )}
+
         <article>
             {(title || section) && (
                 <header class="mb-9 space-y-1">

routes/web.php

@@ -54,7 +54,7 @@
 
 Route::redirect('/discord', 'https://discord.gg/filament')->name('discord');
 
-Route::get('/api/{version?}', function (string $version = '4.x'): RedirectResponse {
+Route::get('/api/{version?}', function (string $version = '3.x'): RedirectResponse {
     return redirect('/api/' . $version . '/index.html');
 })->where('version', '[1-4]+\.x')->name('api-docs');
 
@@ -74,7 +74,7 @@
         $slug = trim($slug, '/');
 
         if (filled($slug) && (! str_contains($slug, '.x'))) {
-            return redirect()->route('docs', ['slug' => "4.x/{$slug}"]);
+            return redirect()->route('docs', ['slug' => "3.x/{$slug}"]);
         }
 
         $filePath = base_path("docs/preserved-dist/{$slug}/index.html");