Add Browser API documentation for in-app browser functionality

- Added new browser.md documentation for Browser::inApp() method
- Documented OAuth authentication use cases with deep link integration
- Included platform-specific behavior for iOS and Android
- Added complete example showing Livewire component implementation
- Covered security considerations and best practices
- Explained integration with deep links for complete OAuth flows

Author: shanerbaner82

resources/views/docs/mobile/1/apis/browser.md

@@ -0,0 +1,116 @@
+---
+title: Browser
+order: 250
+---
+
+## Overview
+
+The Browser API allows you to open URLs in an in-app browser that is "owned" by your application. This is essential when working with OAuth redirects since you need to provide a redirect URL that would naturally open in the user's default browser.
+
+```php
+use Native\Mobile\Facades\Browser;
+```
+
+## Methods
+
+### `inApp()`
+
+Opens a URL in an in-app browser window.
+
+**Parameters:**
+- `string $url` - The URL to open in the in-app browser
+
+```php
+Browser::inApp('https://nativephp.com/mobile');
+```
+
+## Use Cases
+
+### OAuth Authentication
+
+The in-app browser is particularly useful for OAuth flows where you need to:
+- Redirect users to a third-party authentication provider
+- Capture the redirect URL after authentication
+- Return control to your app seamlessly
+
+```php
+use Native\Mobile\Facades\Browser;
+
+class AuthController extends Component
+{
+    public function authenticateWithProvider()
+    {
+        // Open OAuth provider in in-app browser
+        Browser::inApp('https://provider.com/oauth/authorize?client_id=your_client_id&redirect_uri=your_app_scheme://oauth/callback');
+    }
+}
+```
+
+### External Content
+
+Display external content while keeping users within your app:
+
+```php
+// Open documentation
+Browser::inApp('https://docs.example.com/help');
+
+// Open terms of service
+Browser::inApp('https://example.com/terms');
+
+// Open privacy policy
+Browser::inApp('https://example.com/privacy');
+```
+
+## Integration with Deep Links
+
+Use the in-app browser in conjunction with App/Universal/Deep links for complete OAuth flows:
+
+1. **Open OAuth provider** - Use `Browser::inApp()` to start authentication
+2. **User authenticates** - User completes authentication in the in-app browser
+3. **Redirect to app** - OAuth provider redirects to your app's deep link
+4. **Handle in app** - Your app receives the deep link and processes the authentication
+
+```php
+use Native\Mobile\Facades\Browser;
+use Livewire\Attributes\On;
+use Native\Mobile\Events\DeepLink\Received;
+
+class OAuthHandler extends Component
+{
+    public function startOAuth()
+    {
+        Browser::inApp('https://github.com/login/oauth/authorize?client_id=your_client_id&redirect_uri=myapp://oauth/callback');
+    }
+}
+```
+
+## Platform Behavior
+
+### iOS
+- Uses `SFSafariViewController` for the in-app browser
+- Provides native Safari experience within your app
+- Includes address bar, navigation controls, and share functionality
+- Users can easily return to your app
+
+### Android
+- Uses `Chrome Custom Tabs` when available
+- Falls back to `WebView` if Custom Tabs unavailable
+- Provides native browser experience
+- Maintains your app's context
+
+## Best Practices
+
+1. **Use for OAuth flows** - Perfect for authentication redirects
+2. **Keep users in your app** - Better than opening external browser
+3. **Combine with deep links** - Essential for complete OAuth implementation
+4. **Handle errors gracefully** - Network issues or invalid URLs should be handled
+5. **Provide user feedback** - Show loading states when opening URLs
+
+## Security Considerations
+
+- **Validate URLs** - Ensure URLs are from trusted sources
+- **Handle redirects** - Be prepared for OAuth redirects back to your app
+- **Secure communication** - Always use HTTPS for sensitive operations
+- **User consent** - Make it clear when opening external content
+
+The in-app browser provides a seamless way to handle external content and OAuth flows while maintaining your app's user experience.