Publish to pages - fixing base path (#3)

* adding workflows and static site config

* whoops path issue

* adding base path while we don't have a custom domain

* fixing index redirect for static export

* fixing dynamic redirect for static export

Author: beforan

.github/workflows/deploy.docs.yml

@@ -47,6 +47,7 @@ jobs:
           node-version: "24"
 
       - name: Setup Pages
+        id: setup_pages
         uses: actions/configure-pages@v5
 
       - name: Restore cache
@@ -63,6 +64,8 @@ jobs:
 
       - name: Build with Next.js
         run: ${{ steps.detect-package-manager.outputs.runner }} next build
+        env:
+          PAGES_BASE_PATH: ${{ steps.setup_pages.outputs.base_path }}
 
       - name: Copy built files to docs
         run: |

app/page.tsx

@@ -1,5 +1,17 @@
-import { RedirectType, redirect } from "next/navigation";
+"use client";
 
-export default function Home() {
-  redirect("v1", RedirectType.replace);
-}
+import dynamic from "next/dynamic";
+
+// Can't use @next/navigation redirect() in static exports
+// So instead we use Browser `location` API, but we have to prevent the page from pre-rendering
+
+// Client Component that does the redirect
+const RedirectComponent = () => {
+  location.replace("v1");
+  return null;
+};
+
+// export the Component dynamically, with SSR (pre-rendering) disabled, as the Page
+export default dynamic(() => Promise.resolve(RedirectComponent), {
+  ssr: false,
+});

next.config.ts

@@ -8,6 +8,7 @@ const withNextra = nextra({
 
 const nextConfig: NextConfig = {
   output: "export",
+  basePath: process.env.PAGES_BASE_PATH, // TODO: fix when custom domain mapping
   images: {
     unoptimized: true, // mandatory, otherwise won't export
   },