capacitor-statusbar-override/README.md

Capacitor StatusBar plugin override for Android 15+ edge-to-edge without deprecated APIs

# Capacitor StatusBar Override

This package overrides Capacitor's built-in StatusBar plugin to:
- Support Android 15+ edge-to-edge **without deprecated APIs**
- Keep `StatusBar.setBackgroundColor()` working on Android ≤ 14
- Maintain backward compatibility with your existing app code

## Installation

```bash
npm install @yourname/capacitor-statusbar-override
npx cap sync android
```

## Usage
No code changes needed.  
Use it exactly like the original Capacitor StatusBar plugin:

```ts
import { StatusBar } from '@capacitor/status-bar';

await StatusBar.setOverlaysWebView({ overlay: true });
await StatusBar.setBackgroundColor({ color: '#FF0000' });
```

## How It Works
- **Android 15+** → Uses `EdgeToEdge.enable()` for system bar handling.
- **Older Android** → Falls back to `setStatusBarColor()` and manual inset handling.