docs: document device permissions support

Author: V3RON

README.md

@@ -55,6 +55,30 @@ const config = {
 export default config;
 ```
 
+## Device Permissions Fixture
+
+Harness now exposes a deterministic `device.permissions` API for test setup:
+
+```ts
+import { device } from 'react-native-harness';
+
+await device.permissions.grant('microphone');
+await device.permissions.revoke('microphone');
+await device.permissions.reset('microphone');
+
+await device.permissions.grantAll();
+await device.permissions.denyAll();
+await device.permissions.resetAll();
+```
+
+Platform behavior:
+
+- Android emulator and physical device: named permissions and bulk operations use host-side ADB commands.
+- iOS simulator: named permissions and bulk operations use `xcrun simctl privacy` for supported simulator services.
+- iOS physical device: named permission calls warn and no-op; bulk calls configure XCTest Agent prompt handling for future permission prompts.
+
+Existing `permissions: true` config continues to work and now maps to `grantAll()` semantics through the same host-side permission controller.
+
 ## Documentation
 
 The documentation is available at [react-native-harness.dev](https://react-native-harness.dev). You can also use the following links to jump to specific topics:

packages/platform-android/README.md

@@ -52,6 +52,19 @@ const config = {
 export default config;
 ```
 
+## Permissions
+
+Android runners support the shared `device.permissions` fixture API.
+
+```ts
+import { device } from 'react-native-harness';
+
+await device.permissions.grant('camera');
+await device.permissions.denyAll();
+```
+
+Harness resolves bulk operations from the app's declared dangerous permissions and applies them through ADB. Existing config-driven `permissions: true` support is routed through the same controller as `grantAll()`.
+
 ## API
 
 ### `androidPlatform(config)`

packages/platform-ios/README.md

@@ -47,6 +47,23 @@ const config = {
 export default config;
 ```
 
+## Permissions
+
+Apple runners support the shared `device.permissions` fixture API with platform-specific behavior.
+
+```ts
+import { device } from 'react-native-harness';
+
+await device.permissions.grant('photos');
+await device.permissions.resetAll();
+```
+
+- iOS simulator: supported permissions are applied through `xcrun simctl privacy`.
+- iOS physical device: named permission calls warn and no-op; `grantAll()`, `denyAll()`, and `resetAll()` configure XCTest Agent prompt handling for future prompts.
+- iOS simulator `camera` is intentionally unsupported in v1.
+
+Existing config-driven `permissions: true` support is routed through the same controller as `grantAll()`.
+
 ## API
 
 ### `applePlatform(config)`