diff --git a/packages/mobilewright/src/config.ts b/packages/mobilewright/src/config.ts
index 7c00ced..69f65b5 100644
--- a/packages/mobilewright/src/config.ts
+++ b/packages/mobilewright/src/config.ts
@@ -69,6 +69,8 @@ export interface MobilewrightConfig {
   installApps?: string | string[];
   /** Automatically launch the app after connecting. Default: true. */
   autoAppLaunch?: boolean;
+  /** Attach the accessibility tree as JSON to the test report. 'on-failure' attaches on test failure, 'off' disables. Default: 'off'. */
+  viewTree?: 'on-failure' | 'off';
   /** mobilecli server URL (use for remote servers). */
   url?: string;
   /** Path to mobilecli binary (if not on PATH). */
diff --git a/packages/test/src/fixtures.ts b/packages/test/src/fixtures.ts
index 56ded3e..f0aab5e 100644
--- a/packages/test/src/fixtures.ts
+++ b/packages/test/src/fixtures.ts
@@ -33,6 +33,7 @@ type MobilewrightTestFixtures = {
   bundleId: string | undefined;
   platform: 'ios' | 'android' | undefined;
   deviceName: RegExp | undefined;
+  viewTree: 'on-failure' | 'off';
   device: Device;
 };
 
@@ -53,6 +54,15 @@ export const test = base.extend<MobilewrightTestFixtures>({
   platform: [undefined, { option: true }],
   deviceName: [undefined, { option: true }],
 
+  viewTree: [async ({}, use, testInfo) => {
+    const config = await loadConfig(process.cwd(), testInfo.config.configFile);
+    const value = config.viewTree ?? 'off';
+    if (value !== 'on-failure' && value !== 'off') {
+      throw new Error(`Invalid viewTree value: "${value}". Must be "on-failure" or "off".`);
+    }
+    await use(value);
+  }, { option: true }],
+
   device: async ({ platform, deviceName, bundleId }, use, testInfo) => {
     const config = await loadConfig(process.cwd(), testInfo.config.configFile);
     const merged = {
@@ -104,7 +114,7 @@ export const test = base.extend<MobilewrightTestFixtures>({
     }
   },
 
-  screen: async ({ device, video }, use, testInfo) => {
+  screen: async ({ device, video, viewTree }, use, testInfo) => {
     const videoMode = typeof video === 'object' ? video.mode : video;
     const shouldRecord = videoMode === 'on' || videoMode === 'retain-on-failure';
     const videoPath = shouldRecord
@@ -145,6 +155,17 @@ export const test = base.extend<MobilewrightTestFixtures>({
       } catch {
         // device may be disconnected
       }
+      if (viewTree === 'on-failure') {
+        try {
+          const tree = await device.screen.viewTree();
+          await testInfo.attach('view-tree-on-failure', {
+            body: Buffer.from(JSON.stringify(tree, null, 2)),
+            contentType: 'application/json',
+          });
+        } catch {
+          // device may be disconnected
+        }
+      }
     }
   },
 });