fix(website): prevent blank pages after in-place redeployment

Website/instrumentation.ts

@@ -0,0 +1,6 @@
+export async function register() {
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    const { removeStaleRouteCache } = await import('./lib/removeStaleRouteCache');
+    await removeStaleRouteCache();
+  }
+}

Website/lib/removeStaleRouteCache.ts

@@ -0,0 +1,8 @@
+import { rm } from 'fs/promises';
+import path from 'path';
+
+// Pages cached on disk by an earlier deployment take precedence over the current build
+// and reference static chunks that no longer exist. Remove them before serving requests.
+export async function removeStaleRouteCache() {
+  await rm(path.join(process.cwd(), '.next', 'server', 'route-cache'), { recursive: true, force: true });
+}

Website/next.config.ts

@@ -7,6 +7,11 @@ const nextConfig = {
   turbopack: {
     root: path.join(__dirname, '..'),
   },
+  experimental: {
+    // Deployments overwrite the build in place. Pages cached on disk at runtime
+    // would survive the next deployment and reference static chunks that no longer exist.
+    isrFlushToDisk: false,
+  },
   async headers() {
     return [
       {