From 9e863e6cefd50388c9928850ed23fe3cfafedce1 Mon Sep 17 00:00:00 2001
From: Antoine van der Lee <4329185+AvdLee@users.noreply.github.com>
Date: Mon, 27 Jul 2026 14:36:50 +0200
Subject: [PATCH 1/2] seo: add FAQ structured data to the simulator camera doc

Rebased onto master (now includes the #1109 retitle) and onto the
hardened test harness from #1110. The FAQ block and its test are
unchanged in substance from the original branch.
---
 .../capturing/simulator-camera-support.md     |  7 +++++++
 docs/tests/build-output.test.js               | 20 +++++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/docs/src/content/docs/docs/features/capturing/simulator-camera-support.md b/docs/src/content/docs/docs/features/capturing/simulator-camera-support.md
index aa061f84..03fc45cc 100644
--- a/docs/src/content/docs/docs/features/capturing/simulator-camera-support.md
+++ b/docs/src/content/docs/docs/features/capturing/simulator-camera-support.md
@@ -3,6 +3,13 @@ title: "iOS Simulator Camera: Test Camera Flows Without a Device"
 description: "The iOS Simulator has no camera by default. RocketSim streams your Mac camera, images, or video into the Simulator so you can test camera flows."
 sidebar:
   label: "Simulator Camera Support"
+faq:
+  - question: "Can the iOS Simulator use my Mac's camera?"
+    answer: "Not on its own. The Simulator has no camera access, so RocketSim Connect streams images or video from your Mac into the Simulator's camera feed instead."
+  - question: "Do I need a physical iPhone to test camera features?"
+    answer: "No. RocketSim streams a still image or a video file to the Simulator camera, so you can test scanning, capture, and preview flows without a device."
+  - question: "Does camera streaming require RocketSim Connect?"
+    answer: "Yes. The camera feed is delivered through RocketSim Connect, which the recommended setup enables automatically for Xcode debug sessions — no package, framework, or build change required."
 ---
 
 Testing camera flows on the iOS Simulator usually ends with a fallback screen, since the Simulator does not expose a real camera like a physical device. That makes every QR scanner, document scanner, profile photo picker, or video capture flow slower to validate.
diff --git a/docs/tests/build-output.test.js b/docs/tests/build-output.test.js
index 37463528..6f7f28d6 100644
--- a/docs/tests/build-output.test.js
+++ b/docs/tests/build-output.test.js
@@ -63,3 +63,23 @@ test("homepage videos stay deferred", () => {
   const eager = videoTags.filter((tag) => !tag.includes('preload="none"'));
   assert.deepEqual(eager, [], "every homepage video must keep preload=none");
 });
+
+test("camera doc emits FAQPage structured data", () => {
+  const html = readDist(
+    "docs/features/capturing/simulator-camera-support/index.html",
+  );
+  const blocks = [
+    ...html.matchAll(
+      /<script type="application\/ld\+json">([\s\S]*?)<\/script>/g,
+    ),
+  ].map((m) => JSON.parse(m[1]));
+  const faq = blocks.find((b) => b["@type"] === "FAQPage");
+  assert.ok(faq, "expected a FAQPage JSON-LD block");
+  const questions = (faq.mainEntity || []).filter(
+    (entry) => entry["@type"] === "Question",
+  );
+  assert.ok(
+    questions.length >= 3,
+    `expected at least 3 questions in the FAQPage, found ${questions.length}`,
+  );
+});

From 6849559bc647c095d59217ea68840adb8897da17 Mon Sep 17 00:00:00 2001
From: Antoine van der Lee <4329185+AvdLee@users.noreply.github.com>
Date: Mon, 27 Jul 2026 15:13:10 +0200
Subject: [PATCH 2/2] fix: camera streams the selected Mac camera, not image or
 video files

---
 docs/src/collections/feature-page/simulator-camera.md  |  2 +-
 docs/src/content/blog/ios-simulator-camera/index.mdx   | 10 +++++-----
 .../features/capturing/simulator-camera-support.md     | 10 +++++-----
 3 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/src/collections/feature-page/simulator-camera.md b/docs/src/collections/feature-page/simulator-camera.md
index 24a8a7ea..647b8529 100644
--- a/docs/src/collections/feature-page/simulator-camera.md
+++ b/docs/src/collections/feature-page/simulator-camera.md
@@ -1,7 +1,7 @@
 ---
 title: "Simulator Camera"
 meta_title: "Camera Support for the iOS Simulator - RocketSim"
-description: "Test your camera features in the iOS Simulator. Stream your Mac camera, a photo, or a video into any Simulator and skip the deploy-to-device loop."
+description: "Test your camera features in the iOS Simulator. Stream your Mac's camera into any Simulator and skip the deploy-to-device loop."
 hero:
   title: "Simulator Camera"
   subtitle: "Test camera functionality without a physical device"
diff --git a/docs/src/content/blog/ios-simulator-camera/index.mdx b/docs/src/content/blog/ios-simulator-camera/index.mdx
index a5390246..d6f4aed7 100644
--- a/docs/src/content/blog/ios-simulator-camera/index.mdx
+++ b/docs/src/content/blog/ios-simulator-camera/index.mdx
@@ -5,12 +5,12 @@ description: "Use the iOS Simulator camera with RocketSim to test QR scanners, p
 publishedTime: 2026-06-18T18:45:00.000Z
 image: ../../docs/docs/features/capturing/simulator-camera-support/simulator_camera.png
 imageAlt: "RocketSim side window showing Simulator Camera support with camera authorization enabled for an iOS Simulator."
-imageCaption: "RocketSim Camera Simulation lets your Simulator app receive image or video input while you keep working from the Mac."
+imageCaption: "RocketSim Camera Simulation lets your Simulator app receive your Mac's camera feed while you keep working from the Mac."
 ---
 
 The **iOS Simulator camera** is one of those things you expect to just work until you build a feature that depends on it. A QR scanner, document scanner, profile photo picker, or video onboarding flow quickly reminds you that the Simulator does not expose a real camera like an iPhone does.
 
-That usually means you switch to a physical device, grant camera permissions, reproduce the flow, and then go back to Xcode for the next change. It works, but it is slow. RocketSim Camera Simulation closes that gap by streaming images or video into the Simulator through [RocketSim Connect](/docs/getting-started/setting-up-rocketsim-connect).
+That usually means you switch to a physical device, grant camera permissions, reproduce the flow, and then go back to Xcode for the next change. It works, but it is slow. RocketSim Camera Simulation closes that gap by streaming your Mac's camera into the Simulator through [RocketSim Connect](/docs/getting-started/setting-up-rocketsim-connect).
 
 ## Why camera testing is slow
 
@@ -34,8 +34,8 @@ I have made this mistake myself while building camera-related flows: I postponed
     <source src="/features/simulator-camera.mp4" type="video/mp4" />
   </video>
   <figcaption>
-    RocketSim can stream media into your Simulator app so you can test camera
-    flows without deploying to a physical device.
+    RocketSim can stream your Mac's camera into your Simulator app so you can
+    test camera flows without deploying to a physical device.
   </figcaption>
 </figure>
 
@@ -52,7 +52,7 @@ You can use the iOS Simulator camera workflow for scenarios like:
 - Testing QR code or barcode scanning
 - Validating profile photo and avatar flows
 - Checking document capture or identity screens
-- Replaying a known video input for repeatable testing
+- Using your iPhone as the camera input through Continuity Camera
 - Verifying permission and empty states
 - Testing how your UI behaves when no camera is available
 
diff --git a/docs/src/content/docs/docs/features/capturing/simulator-camera-support.md b/docs/src/content/docs/docs/features/capturing/simulator-camera-support.md
index 03fc45cc..c95c529a 100644
--- a/docs/src/content/docs/docs/features/capturing/simulator-camera-support.md
+++ b/docs/src/content/docs/docs/features/capturing/simulator-camera-support.md
@@ -1,22 +1,22 @@
 ---
 title: "iOS Simulator Camera: Test Camera Flows Without a Device"
-description: "The iOS Simulator has no camera by default. RocketSim streams your Mac camera, images, or video into the Simulator so you can test camera flows."
+description: "The iOS Simulator has no camera by default. RocketSim streams your Mac's camera into the Simulator so you can test camera flows without a device."
 sidebar:
   label: "Simulator Camera Support"
 faq:
   - question: "Can the iOS Simulator use my Mac's camera?"
-    answer: "Not on its own. The Simulator has no camera access, so RocketSim Connect streams images or video from your Mac into the Simulator's camera feed instead."
+    answer: "Not on its own. The Simulator has no camera access, so RocketSim Connect streams your selected Mac camera into the Simulator's camera feed instead."
   - question: "Do I need a physical iPhone to test camera features?"
-    answer: "No. RocketSim streams a still image or a video file to the Simulator camera, so you can test scanning, capture, and preview flows without a device."
+    answer: "No. RocketSim streams a camera connected to your Mac into the Simulator, so you can test scanning, capture, and preview flows without a device."
   - question: "Does camera streaming require RocketSim Connect?"
-    answer: "Yes. The camera feed is delivered through RocketSim Connect, which the recommended setup enables automatically for Xcode debug sessions — no package, framework, or build change required."
+    answer: "Yes. The camera feed is delivered through RocketSim Connect, which the recommended setup enables automatically for Xcode debug sessions, without any package, framework, or build change."
 ---
 
 Testing camera flows on the iOS Simulator usually ends with a fallback screen, since the Simulator does not expose a real camera like a physical device. That makes every QR scanner, document scanner, profile photo picker, or video capture flow slower to validate.
 
 ## Does the iOS Simulator have a camera?
 
-No, Xcode's Simulator does not come with camera support: apps won't discover any capture device. RocketSim adds this missing camera by streaming your Mac's camera, a photo, or a video into your running Simulator app through RocketSim Connect. You can keep your normal Simulator workflow and test camera-dependent UI without repeatedly deploying to an iPhone.
+No, Xcode's Simulator does not come with camera support: apps won't discover any capture device. RocketSim adds this missing camera by streaming a camera connected to your Mac, like the built-in camera or an iPhone via Continuity Camera, into your running Simulator app through RocketSim Connect. You can keep your normal Simulator workflow and test camera-dependent UI without repeatedly deploying to an iPhone.
 
 You can find an overview of what's possible on the [Simulator Camera feature page](/features/simulator-camera/).