docs: simplify React Native setup guidance

Present the Metro integration as the standard React Native setup and keep version history in one compatibility note.

Author: V3RON

.changeset/quiet-walls-connect.md

@@ -2,6 +2,6 @@
 'agent-react-devtools': minor
 ---
 
-Add React Native 0.87+ support through a Metro config wrapper and native
-bootstrap entry. React Native apps now wrap their final Metro config and import
+Add React Native support through a Metro config wrapper and native bootstrap
+entry. React Native apps now wrap their final Metro config and import
 `agent-react-devtools/react-native` from the application entry graph.

README.md

@@ -241,10 +241,11 @@ Options:
 reactDevtools({ port: 8097, host: "localhost" });
 ```
 
-### React Native 0.87+
+### React Native
 
-React Native 0.87 removed the legacy standalone React DevTools auto-connect
-path. Projects must now add the agent bootstrap to Metro explicitly:
+> Before React Native 0.87, standalone DevTools connected automatically without
+> code changes. React Native 0.87 removed that path, so the setup below is now
+> required.
 
 ```sh
 npm install --save-dev agent-react-devtools
@@ -322,17 +323,17 @@ launching the app:
 adb reverse tcp:8097 tcp:8097
 ```
 
-This integration connects only from a native development runtime and only on
-React Native 0.87 or newer. Native production builds exit without connecting;
-browser and default/server imports resolve to no-op modules.
+This integration connects only from a native development runtime. Native
+production builds exit without connecting; browser and default/server imports
+resolve to no-op modules.
 
 If `status` reports zero connected apps:
 
 1. Confirm both the Metro wrapper and graph import are present.
 2. Ensure `withAgentReactDevTools` wraps the final config, outside other Metro wrappers.
 3. Stop and restart Metro; if its cache is stale, use `--reset-cache` (bare) or `npx expo start -c`.
 4. Confirm the daemon is listening on 8097 and repeat `adb reverse` for Android devices.
-5. Check that the app is a development build running React Native 0.87+.
+5. Check that the app is a development build.
 
 ## Using with agent-browser
 

examples/expo-app/README.md

@@ -1,12 +1,12 @@
 # Expo Example App
 
-A minimal Expo app showing the React Native 0.87+ `agent-react-devtools`
+A minimal Expo app showing the React Native `agent-react-devtools`
 configuration.
 
 > This fixture currently uses React Native 0.81.5, so its client-side version
 > guard intentionally makes the bootstrap a no-op. It validates the Metro and
-> application configuration shape, but does not validate the React Native 0.87
-> runtime connection.
+> application configuration shape, but does not validate the runtime
+> connection.
 
 ## Setup
 
@@ -26,8 +26,8 @@ The example already contains both required integration points:
   graph.
 
 This checked-in React Native 0.81 fixture cannot test a live connection. To
-exercise the same configuration in an Expo project based on React Native 0.87
-or newer, restart Metro and run:
+exercise the same configuration in an Expo project where the bootstrap is
+active, restart Metro and run:
 
 ```sh
 # Terminal 1: Start the daemon

packages/agent-react-devtools/skills/react-devtools/SKILL.md

@@ -167,7 +167,7 @@ agent-react-devtools status  # Should show 1 connected app
 ## Important Rules
 
 - **Labels reset** when the app reloads or components unmount/remount. After a reload, use `wait --connected` then re-check with `get tree` or `find`.
-- **`status` first** — if status shows 0 connected apps, the React app is not connected. Web users may need to run `npx agent-react-devtools init`; React Native 0.87+ users need both manual steps in [setup.md](references/setup.md).
+- **`status` first** — if status shows 0 connected apps, the React app is not connected. Web users may need to run `npx agent-react-devtools init`; React Native users need both manual steps in [setup.md](references/setup.md).
 - **Headed browser required** — if using `agent-browser`, always use `--headed` mode. Headless Chromium does not properly load the devtools connect script.
 - **Profile while interacting** — profiling only captures renders that happen between `profile start` and `profile stop`. Make sure the relevant interaction happens during that window.
 - **Use `--depth`** on large trees — a deep tree can produce a lot of output. Start with `--depth 3` or `--depth 4` and go deeper only on the subtree you care about.

packages/agent-react-devtools/skills/react-devtools/references/setup.md

@@ -57,9 +57,8 @@ Then imports it in `app/layout.tsx`.
 import 'agent-react-devtools/connect';
 ```
 
-### React Native 0.87+ / Expo
+### React Native / Expo
 
-React Native 0.87 removed the legacy standalone DevTools auto-connect path.
 The Metro wrapper and entry-graph import below are both mandatory.
 
 ```bash
@@ -114,9 +113,9 @@ agent-react-devtools wait --connected --timeout 30
 agent-react-devtools status
 ```
 
-The client connects only from React Native 0.87+ native development runtimes.
-Native production builds exit without connecting; web and default/server
-imports resolve to no-op modules.
+The client connects only from native development runtimes. Native production
+builds exit without connecting; web and default/server imports resolve to
+no-op modules.
 
 ## Manual Web Setup
 

packages/agent-react-devtools/src/__tests__/init.test.ts

@@ -200,7 +200,7 @@ describe('runInit', () => {
     expect(content).toBe(original);
   });
 
-  it('prints manual React Native 0.87 setup without modifying files', async () => {
+  it('prints manual React Native setup without modifying files', async () => {
     const packageJson = JSON.stringify({
       dependencies: { 'react-native': '^0.87.0' },
     });
@@ -216,7 +216,8 @@ describe('runInit', () => {
       await runInit(dir, true);
 
       const output = log.mock.calls.flat().join('\n');
-      expect(output).toContain('React Native 0.87+ requires manual setup');
+      expect(output).toContain('React Native requires manual setup');
+      expect(output).not.toContain('0.87');
       expect(output).toContain('npm install -D agent-react-devtools');
       expect(output).not.toContain('react-devtools-core');
       expect(output).toContain('withAgentReactDevTools');

packages/agent-react-devtools/src/init.ts

@@ -362,7 +362,7 @@ export async function runInit(
   }
 
   if (framework === 'react-native') {
-    console.log('\nReact Native 0.87+ requires manual setup.');
+    console.log('\nReact Native requires manual setup.');
     console.log('No files were changed by init.\n');
     console.log('1. Install agent-react-devtools:');
     console.log('   npm install -D agent-react-devtools\n');