feat: cross-platform local QA pipeline with Playwright, Maestro, and TV YAML runner

apps/mobile/.gitignore

@@ -31,3 +31,6 @@ yarn-error.*
 
 # typescript
 *.tsbuildinfo
+
+# e2e screenshots
+e2e/screenshots/

apps/mobile/.maestro/accordion-cta.yaml

@@ -0,0 +1,16 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - accordion
+  - cta
+---
+# Accordion CTA — Header button tap
+- launchApp
+- waitForAnimationToEnd
+- scroll
+
+# Tap CTA button in header
+- tapOn:
+    id: "accordion-cta"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/accordion-cta/tapped

apps/mobile/.maestro/accordion-questions.yaml

@@ -0,0 +1,31 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - accordion
+  - questions
+---
+# Related Questions Accordion — Expand, collapse, single open
+- launchApp
+- waitForAnimationToEnd
+- scroll
+- takeScreenshot: ../e2e/screenshots/${platform}/accordion-questions/visible
+
+# Tap first question
+- tapOn:
+    id: "accordion-question-0"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/accordion-questions/expanded
+
+# Tap second question (first should collapse)
+- tapOn:
+    id: "accordion-question-1"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/accordion-questions/second-expanded
+
+# Collapse
+- tapOn:
+    id: "accordion-question-1"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/accordion-questions/all-collapsed

apps/mobile/.maestro/appstate-background.yaml

@@ -0,0 +1,15 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - appstate
+  - lifecycle
+---
+# AppState Background/Foreground — Video pause/resume
+- launchApp
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/appstate-background/foreground
+
+# Note: Maestro cannot directly simulate app backgrounding, but we can
+# verify the app loads correctly after relaunch
+- launchApp
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/appstate-background/relaunched

apps/mobile/.maestro/appstate-video.yaml

@@ -0,0 +1,23 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - appstate
+  - video
+---
+# AppState Video — Mute persists, hero re-mutes on nav away
+- launchApp
+- waitForAnimationToEnd
+
+# Toggle mute
+- tapOn:
+    id: "mute-button"
+    optional: true
+- takeScreenshot: ../e2e/screenshots/${platform}/appstate-video/mute-toggled
+
+# Navigate away and back
+- tapOn:
+    id: "tab-discover"
+- waitForAnimationToEnd
+- tapOn:
+    id: "tab-home"
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/appstate-video/returned-home

apps/mobile/.maestro/carousel-bible-quotes.yaml

@@ -0,0 +1,29 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - carousel
+  - bible-quotes
+---
+# Bible Quotes Carousel — Paged, pagination dots, share
+- launchApp
+- waitForAnimationToEnd
+- scroll
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-bible-quotes/visible
+
+# Swipe to next quote
+- swipe:
+    direction: LEFT
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-bible-quotes/next-quote
+
+# Share button
+- tapOn:
+    id: "share-quote"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-bible-quotes/share-sheet
+
+# CTA link
+- tapOn:
+    id: "quote-cta"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-bible-quotes/cta-tapped

apps/mobile/.maestro/carousel-media.yaml

@@ -0,0 +1,22 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - carousel
+  - media
+---
+# Media Collection Carousel — 3:4 cards, badges, labels
+- launchApp
+- waitForAnimationToEnd
+- scroll
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-media/visible
+
+# Swipe through
+- swipe:
+    direction: LEFT
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-media/swiped
+
+# Tap a media item
+- tapOn:
+    id: "media-collection-item-0"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-media/tapped

apps/mobile/.maestro/carousel-navigation.yaml

@@ -0,0 +1,21 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - carousel
+  - navigation
+---
+# Navigation Carousel — Scroll-to-section, category labels
+- launchApp
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-navigation/visible
+
+# Tap a navigation item
+- tapOn:
+    id: "nav-carousel-item-0"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-navigation/scrolled-to-section
+
+# Swipe navigation carousel
+- swipe:
+    direction: LEFT
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-navigation/swiped

apps/mobile/.maestro/carousel-video.yaml

@@ -0,0 +1,22 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - carousel
+  - video
+---
+# Video Carousel — Horizontal scroll, portrait cards, tap navigation
+- launchApp
+- waitForAnimationToEnd
+- scroll
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-video/visible
+
+# Swipe carousel horizontally
+- swipe:
+    direction: LEFT
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-video/swiped
+
+# Tap a card
+- tapOn:
+    id: "video-carousel-card-0"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/carousel-video/card-tapped

apps/mobile/.maestro/collection-player-states.yaml

@@ -0,0 +1,20 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - collection
+  - states
+---
+# Collection Player States — Loading, no playable, disabled items
+- launchApp
+- waitForAnimationToEnd
+- scroll
+- tapOn:
+    id: "collection-card-0"
+    optional: true
+- takeScreenshot: ../e2e/screenshots/${platform}/collection-player-states/loading
+
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/collection-player-states/loaded
+
+# Scroll to see playlist items with disabled state
+- scroll
+- takeScreenshot: ../e2e/screenshots/${platform}/collection-player-states/playlist-items

apps/mobile/.maestro/collection-player-switch.yaml

@@ -0,0 +1,24 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - collection
+  - switching
+---
+# Collection Player Switch — Tap item to switch video
+- launchApp
+- waitForAnimationToEnd
+- scroll
+- tapOn:
+    id: "collection-card-0"
+    optional: true
+- waitForAnimationToEnd
+
+# Tap a different playlist item
+- scroll
+- tapOn:
+    id: "playlist-item-1"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/collection-player-switch/switched
+
+# Verify active item badge
+- takeScreenshot: ../e2e/screenshots/${platform}/collection-player-switch/active-badge

apps/mobile/.maestro/collection-player.yaml

@@ -0,0 +1,23 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - collection
+  - player
+---
+# Collection Player — Playlist, active item, auto-advance
+- launchApp
+- waitForAnimationToEnd
+- scroll
+
+# Navigate to a collection
+- tapOn:
+    id: "collection-card-0"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/collection-player/loaded
+
+# Verify 16:9 player
+- takeScreenshot: ../e2e/screenshots/${platform}/collection-player/player-dimensions
+
+# Scroll to playlist
+- scroll
+- takeScreenshot: ../e2e/screenshots/${platform}/collection-player/playlist

apps/mobile/.maestro/discover-clear.yaml

@@ -0,0 +1,20 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - discover
+---
+# Discover Clear Search — Reset to empty state
+- launchApp
+- tapOn:
+    id: "tab-discover"
+- waitForAnimationToEnd
+
+- tapOn:
+    id: "search-input"
+    optional: true
+- inputText: "Jesus"
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-clear/with-results
+
+- eraseText
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-clear/cleared

apps/mobile/.maestro/discover-error.yaml

@@ -0,0 +1,18 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - discover
+  - error
+---
+# Discover Error — Network error, rate limit handling
+- launchApp
+- tapOn:
+    id: "tab-discover"
+- waitForAnimationToEnd
+
+# Search to trigger potential error states
+- tapOn:
+    id: "search-input"
+    optional: true
+- inputText: "test"
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-error/state

apps/mobile/.maestro/discover-keyboard.yaml

@@ -0,0 +1,20 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - discover
+  - keyboard
+---
+# Discover Keyboard — Dismiss on scroll
+- launchApp
+- tapOn:
+    id: "tab-discover"
+- waitForAnimationToEnd
+
+- tapOn:
+    id: "search-input"
+    optional: true
+- inputText: "Jesus"
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-keyboard/keyboard-visible
+
+# Scroll to dismiss keyboard
+- scroll
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-keyboard/keyboard-dismissed

apps/mobile/.maestro/discover-no-results.yaml

@@ -0,0 +1,17 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - discover
+  - empty
+---
+# Discover No Results — Empty state for nonexistent query
+- launchApp
+- tapOn:
+    id: "tab-discover"
+- waitForAnimationToEnd
+
+- tapOn:
+    id: "search-input"
+    optional: true
+- inputText: "xyznonexistentquery12345"
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-no-results/empty-state

apps/mobile/.maestro/discover-pagination.yaml

@@ -0,0 +1,27 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - discover
+  - pagination
+---
+# Discover Pagination — Load more results
+- launchApp
+- tapOn:
+    id: "tab-discover"
+- waitForAnimationToEnd
+
+- tapOn:
+    id: "search-input"
+    optional: true
+- inputText: "Jesus"
+- waitForAnimationToEnd
+
+# Scroll to load more
+- scroll
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-pagination/scrolled
+
+# Tap load more if visible
+- tapOn:
+    text: "Load more"
+    optional: true
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-pagination/more-loaded

apps/mobile/.maestro/discover-rapid-typing.yaml

@@ -0,0 +1,23 @@
+appId: org.jesusfilm.forgewatch
+tags:
+  - discover
+  - debounce
+---
+# Discover Rapid Typing — Only latest query fires (requestId)
+- launchApp
+- tapOn:
+    id: "tab-discover"
+- waitForAnimationToEnd
+
+- tapOn:
+    id: "search-input"
+    optional: true
+- inputText: "first"
+- waitForAnimationToEnd
+- eraseText
+- inputText: "second"
+- waitForAnimationToEnd
+- eraseText
+- inputText: "Jesus"
+- waitForAnimationToEnd
+- takeScreenshot: ../e2e/screenshots/${platform}/discover-rapid-typing/latest-result