feat: add staging (pre-release) channel to download page

Surface beta/RC builds from the bucket's staging/ prefix on the
Download page instead of requiring users to dig through the package
browser, using the same fetch/sort/URL logic already wired for the
stable and dev channels.

Assisted-by: Claude Code:claude-sonnet-5

Author: gsanchietti

docs/administrator-manual/installation/download.mdx

@@ -3,7 +3,7 @@ title: Download
 sidebar_position: 2
 ---
 
-import {StableReleases, DevReleases, ImageVerifyCommand} from '@site/src/components/DownloadTable';
+import {StableReleases, StagingReleases, DevReleases, ImageVerifyCommand} from '@site/src/components/DownloadTable';
 
 # Download {#download-section}
 
@@ -29,6 +29,12 @@ The tables below list the available releases along with their respective downloa
 
 <StableReleases />
 
+## Staging releases
+
+Staging releases are pre-release builds shipped ahead of a stable release, such as beta and release candidate (RC) images. They are more stable than development builds but are not yet recommended for production use.
+
+<StagingReleases />
+
 ## Development releases
 
 <DevReleases />

src/components/DownloadTable/index.tsx

@@ -41,6 +41,13 @@ export function StableReleases(): ReactNode {
   return <ReleaseTable rows={data?.stable ?? []} />;
 }
 
+export function StagingReleases(): ReactNode {
+  const {data, loading, error} = useVersionData();
+  if (loading) return <p>Loading releases…</p>;
+  if (error) return <p>Could not load releases: {error}</p>;
+  return <ReleaseTable rows={data?.staging ?? []} />;
+}
+
 export function DevReleases(): ReactNode {
   const {data, loading, error} = useVersionData();
   if (loading) return <p>Loading releases…</p>;
@@ -57,6 +64,7 @@ const FALLBACK: VersionData = {
   imageNoGz: 'nethsecurity-<version>-x86-64-generic-squashfs-combined-efi.img',
   downloadUrl: '#',
   stable: [],
+  staging: [],
   dev: [],
 };
 

src/hooks/useVersionData.ts

@@ -17,6 +17,7 @@ export type VersionData = {
   imageNoGz: string;
   downloadUrl: string;
   stable: Release[];
+  staging: Release[];
   dev: Release[];
 };
 
@@ -140,18 +141,20 @@ export function useVersionData(): UseVersionDataResult {
 
     async function load() {
       try {
-        const [versionText, stableFolders, devFolders] = await Promise.all([
+        const [versionText, stableFolders, stagingFolders, devFolders] = await Promise.all([
           // Degrade gracefully if latest_release has CORS issues.
           fetch(`${BASE_URL}/stable/latest_release`)
             .then((r) => (r.ok ? r.text() : ''))
             .catch(() => ''),
           collectReleases('stable'),
+          collectReleases('staging'),
           collectReleases('dev'),
         ]);
 
         if (cancelled) return;
 
         const stable = buildRows('stable', stableFolders);
+        const staging = buildRows('staging', stagingFolders);
         const dev = buildRows('dev', devFolders);
         const version = versionText.trim() || (stable[0]?.version ?? '');
         const image = version ? imageName(version) : '';
@@ -162,6 +165,7 @@ export function useVersionData(): UseVersionDataResult {
           imageNoGz: image.replace(/\.gz$/, ''),
           downloadUrl: version ? makeImageUrl('stable', version) : '',
           stable,
+          staging,
           dev,
         };
         _cache = result;