From f52c31367a14f8a9d7fdf2d2bfc86e441702dc9a Mon Sep 17 00:00:00 2001
From: Bryan Van Deusen <bryan.vandeusen@fabledsword.com>
Date: Sun, 17 May 2026 16:29:21 -0400
Subject: [PATCH] feat(reader): immersive series-read route + route-aware
 AppShell (suppress TopNav)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 frontend/src/components/AppShell.vue | 14 ++++++++++----
 frontend/src/router.js               |  3 +++
 frontend/test/router.spec.js         |  6 ++++++
 3 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/frontend/src/components/AppShell.vue b/frontend/src/components/AppShell.vue
index d4a53dc..3546e40 100644
--- a/frontend/src/components/AppShell.vue
+++ b/frontend/src/components/AppShell.vue
@@ -1,12 +1,18 @@
 <template>
-  <TopNav />
-  <main class="fc-content">
-    <slot />
-  </main>
+  <slot v-if="route.meta.immersive" />
+  <template v-else>
+    <TopNav />
+    <main class="fc-content">
+      <slot />
+    </main>
+  </template>
 </template>
 
 <script setup>
+import { useRoute } from 'vue-router'
 import TopNav from './TopNav.vue'
+
+const route = useRoute()
 </script>
 
 <style scoped>
diff --git a/frontend/src/router.js b/frontend/src/router.js
index 8b74950..601c2d0 100644
--- a/frontend/src/router.js
+++ b/frontend/src/router.js
@@ -6,6 +6,7 @@ import ShowcaseView from './views/ShowcaseView.vue'
 import TagsView from './views/TagsView.vue'
 import ArtistView from './views/ArtistView.vue'
 import SeriesManageView from './views/SeriesManageView.vue'
+import SeriesReaderView from './views/SeriesReaderView.vue'
 
 // The application's front door. `/` redirects here. Changing the front door
 // is a one-line edit (e.g. '/gallery' or '/tags').
@@ -23,6 +24,8 @@ const routes = [
   { path: '/artist/:slug', name: 'artist', component: ArtistView },
   // Series management — no meta.title (reached from a series tag card).
   { path: '/series/:tagId', name: 'series-manage', component: SeriesManageView },
+  // Series reader — immersive (no top nav, no meta.title).
+  { path: '/series/:tagId/read', name: 'series-read', component: SeriesReaderView, meta: { immersive: true } },
   { path: '/settings', name: 'settings', component: SettingsView, meta: { title: 'Settings' } },
 
   // FC-3: subscription backbone
diff --git a/frontend/test/router.spec.js b/frontend/test/router.spec.js
index 155ff7f..c976fd3 100644
--- a/frontend/test/router.spec.js
+++ b/frontend/test/router.spec.js
@@ -23,4 +23,10 @@ describe('router', () => {
     expect(router.resolve('/artist/some-slug').name).toBe('artist')
     expect(router.resolve('/artist/some-slug').params.slug).toBe('some-slug')
   })
+
+  it('series-read is an immersive route', () => {
+    const r = router.resolve('/series/5/read')
+    expect(r.name).toBe('series-read')
+    expect(r.meta.immersive).toBe(true)
+  })
 })