used on still requires refreshes (TBD)

Author: codercatdev

apps/sanity/sanity.config.ts

@@ -56,7 +56,7 @@ const apiVersion = process.env.SANITY_STUDIO_API_VERSION || "2025-09-30";
 
 // Set SANITY_STUDIO_DISABLE_PRESENTATION=true if you get network errors to api.sanity.io (e.g. firewall/VPN)
 const presentationEnabled =
-	process.env.SANITY_STUDIO_DISABLE_PRESENTATION !== "true";
+  process.env.SANITY_STUDIO_DISABLE_PRESENTATION !== "true";
 
 // Use local Astro dev server for presentation preview when running Studio locally
 const isLocal =
@@ -69,6 +69,8 @@ function resolveHref(type: string, slug?: string): string | undefined {
   switch (type) {
     case "post":
       return slug ? `/post/${slug}` : undefined;
+    case "podcast":
+      return slug ? `/podcast/${slug}` : undefined;
     case "page":
       return slug ? `/${slug}` : undefined;
     default:
@@ -222,6 +224,22 @@ function buildPlugins(previewUrl: string): PluginOptions[] {
                     ],
                   }),
                 }),
+                podcast: defineLocations({
+                  select: {
+                    title: "title",
+                    slug: "slug.current",
+                  },
+                  resolve: (doc) => ({
+                    locations: [
+                      {
+                        title: doc?.title || "Untitled",
+                        // biome-ignore lint/style/noNonNullAssertion: resolveHref returns string for known types
+                        href: resolveHref("podcast", doc?.slug)!,
+                      },
+                      homeLocation,
+                    ],
+                  }),
+                }),
               },
             },
             previewUrl: {
@@ -237,10 +255,7 @@ function buildPlugins(previewUrl: string): PluginOptions[] {
         ]
       : []),
     structureTool({ structure: podcastStructure() }),
-    singletonPlugin([
-      settings.name,
-      engineConfig.name,
-    ]),
+    singletonPlugin([settings.name, engineConfig.name]),
     assistWithPresets(),
     media(),
     codeInput(),

apps/web/src/middleware.ts

@@ -77,5 +77,23 @@ export const onRequest = defineMiddleware(async (context, next) => {
     return context.redirect("/login");
   }
 
-  return next();
+  const response = await next();
+
+  // Prevent caching when in Sanity draft/preview mode so iframe refresh always shows current content
+  const cookieHeader = context.request.headers.get("Cookie") ?? "";
+  if (cookieHeader.includes("__sanity_preview=")) {
+    const headers = new Headers(response.headers);
+    headers.set(
+      "Cache-Control",
+      "no-store, no-cache, must-revalidate, max-age=0, proxy-revalidate",
+    );
+    headers.set("Pragma", "no-cache");
+    return new Response(response.body, {
+      status: response.status,
+      statusText: response.statusText,
+      headers,
+    });
+  }
+
+  return response;
 });

apps/web/src/pages/api/draft-mode/enable.ts

@@ -79,7 +79,9 @@ export const GET: APIRoute = async ({ url, cookies, request }) => {
 
     if (isValid) {
       const isLocal = url.hostname === "localhost";
-      const redirectPath = safeRedirectPath(redirectTo ?? "/", origin);
+      // redirectTo comes from validatePreviewUrl (sanity-preview-pathname param); fallback to param directly
+      const pathFromParam = url.searchParams.get("sanity-preview-pathname") ?? undefined;
+      const redirectPath = safeRedirectPath(redirectTo ?? pathFromParam ?? "/", origin);
       const location = `${origin}${redirectPath}`;
 
       cookies.set("__sanity_preview", "1", {

apps/web/src/scripts/visual-editing.ts

@@ -1,9 +1,10 @@
 /**
- * Sanity Visual Editing (Plain JS).
- * Loaded only when visual editing is enabled; integrates with History API for Presentation tool.
- * Listens for presentation/perspective postMessages so switching perspective in Studio reloads
- * the preview with the correct sanity-preview-perspective URL param (outer context URL change
- * is not reflected in the iframe, so we must handle the message).
+ * Sanity Visual Editing (Plain JS) — minimal integration per official docs.
+ * https://reference.sanity.io/_sanity/visual-editing/
+ *
+ * History update uses pushState/replaceState only so the Studio can drive
+ * iframe navigation (e.g. by loading the preview URL when you click locations).
+ * We only handle presentation/perspective so perspective switches reload with the right param.
  */
 import { enableVisualEditing } from "@sanity/visual-editing";
 
@@ -57,27 +58,25 @@ export function run(): () => void {
         switch (update.type) {
           case "push":
             window.history.pushState(null, "", update.url);
-            // Reload so the new URL (e.g. perspective param) is loaded and server fetches correct data
-            window.location.reload();
             break;
           case "pop":
             window.history.back();
             break;
           case "replace":
             window.history.replaceState(null, "", update.url);
-            window.location.reload();
             break;
           default:
             throw new Error(`Unknown update type: ${(update as { type: string }).type}`);
         }
       },
     },
     zIndex: 1000,
+    // Let default behavior apply: manual = reload, mutation = no default for Plain JS
     refresh: async (payload) => {
-      // Reload preview when user clicks Refresh or when a document is saved in Studio
-      if (payload.source === "manual" || payload.source === "mutation") {
+      if (payload.source === "manual") {
         window.location.reload();
       }
+      // source === 'mutation': no default for Plain JS per docs; don't reload unless you want to
     },
   });