build: update github workflow

Author: manuelodelain

.github/workflows/deploy-stories.yml

@@ -54,11 +54,12 @@ jobs:
         env:
           NUXT_STORIES: "1"
           NUXT_STORIES_MODE: frame
-          # Base path matching the GitHub Pages URL: https://rezozero.github.io/nuxt-stories/
-          NUXT_APP_BASE_URL: /nuxt-stories/
+          # Frame gets its own sub-base so its _nuxt/ assets land under /-frame/_nuxt/
+          # after the merge, preventing collision with the shell's _nuxt/ bundle.
+          NUXT_APP_BASE_URL: /nuxt-stories/-frame/
 
       - name: Save frame output
-        run: mv playground/.output/public playground/.output/frame-public
+        run: mkdir -p playground/.output-tmp && mv playground/.output/public playground/.output-tmp/frame-public
 
       # ── Shell pass ──────────────────────────────────────────────────────────
       # Generates the stories UI (nav + iframe wrapper)
@@ -77,7 +78,7 @@ jobs:
 
       - name: Merge frame output into shell output
         run: |
-          cp -r playground/.output/frame-public/-frame playground/.output/public/-frame
+          cp -r playground/.output-tmp/frame-public playground/.output/public/-frame && rm -rf playground/.output-tmp
 
       # GitHub Pages ignores folders prefixed with _ by default; .nojekyll disables this.
       - name: Add .nojekyll

src/module.ts

@@ -97,6 +97,14 @@ export default defineNuxtModule<NuxtStoriesOptions>({
         const routeBasePath = joinURL('/', options.route?.path || '')
         const frameBasePath = routeBasePath === '/' ? '/-frame' : routeBasePath + '-frame'
 
+        // In a two-pass static build (GitHub Actions) the frame is generated with
+        // NUXT_APP_BASE_URL=/base/-frame/ so the iframe-facing /-frame/* path is already
+        // encoded in the base URL.  Routes must therefore live at / (not /-frame/*) so
+        // that the generated files don't get an extra /-frame/ prefix that would make
+        // them double-nested after the merge step.
+        const staticFrameMode = mode === 'frame' && !nuxt.options.dev
+        const effectiveFrameBasePath = staticFrameMode ? '/' : frameBasePath
+
         // In shell mode with a separate frame process the iframe points to the frame server URL.
         // When frameCwd is not set or in other modes the iframe uses same-origin routes.
         const frameBaseUrl = mode === 'shell' && nuxt.options.dev && options.frameCwd
@@ -233,7 +241,7 @@ export default defineNuxtModule<NuxtStoriesOptions>({
             name: 'stories-frame',
             file: resolver.resolve('./runtime/components/StoryFramePage.vue'),
             meta: { layout: false },
-            path: joinURL(frameBasePath, '/:story*'),
+            path: joinURL(effectiveFrameBasePath, '/:story*'),
             children: frameChildren,
         }
 
@@ -286,9 +294,10 @@ export default defineNuxtModule<NuxtStoriesOptions>({
         // Shell mode: only registers shell routes (reads story file paths for nav but renders via iframe)
         // Frame mode: only registers frame routes (renders actual story components)
         // All mode: both (single-process, backward-compatible)
-        extendPages(async (pages) => {
-            const storyPaths: string[] = []
+        // Shared story paths — populated in extendPages, consumed in nitro:config
+        const storyPaths: string[] = []
 
+        extendPages(async (pages) => {
             if (mode === 'shell') {
                 pages.length = 0 // clear existing routes so only the shell route is registered at top level
             }
@@ -319,18 +328,6 @@ export default defineNuxtModule<NuxtStoriesOptions>({
 
             if (mode === 'shell' || mode === 'all') pages.push(shellRoute)
             if (mode === 'frame' || mode === 'all') pages.push(frameRoute)
-
-            // Register all story paths for static generation (nuxi generate)
-            nuxt.options.nitro.prerender ||= {}
-            nuxt.options.nitro.prerender.routes = [
-                ...(nuxt.options.nitro.prerender.routes as string[] ?? []),
-                ...(mode === 'shell' || mode === 'all'
-                    ? storyPaths.map((p) => joinURL(routeBasePath, p))
-                    : []),
-                ...(mode === 'frame' || mode === 'all'
-                    ? storyPaths.map((p) => joinURL(frameBasePath, p))
-                    : []),
-            ]
         })
 
         // WATCH (dev only)
@@ -351,6 +348,22 @@ export default defineNuxtModule<NuxtStoriesOptions>({
 
         // NITRO CONFIG — serve the module's static public assets (stories.css, etc.)
         nuxt.hook('nitro:config', (nitroConfig) => {
+            // Register story paths for static generation (nuxi generate).
+            // Done here (not inside extendPages) to guarantee the routes are visible
+            // to Nitro — pages:extend is awaited before nitro:config fires.
+            if (storyPaths.length > 0) {
+                nitroConfig.prerender ||= {}
+                nitroConfig.prerender.routes = [
+                    ...(nitroConfig.prerender.routes ?? []),
+                    ...(mode === 'shell' || mode === 'all'
+                        ? storyPaths.map((p) => joinURL(routeBasePath, p))
+                        : []),
+                    ...(mode === 'frame' || mode === 'all'
+                        ? storyPaths.map((p) => joinURL(effectiveFrameBasePath, p))
+                        : []),
+                ]
+            }
+
             nitroConfig.publicAssets ||= []
             nitroConfig.publicAssets.push({
                 dir: resolver.resolve('./runtime/public'),