> These docs cover Nitro Cookies 1.3.0. List APIs, scoped deletion, and normalized errors are available from 1.3.0. Check the installation guide and release history when upgrading from an earlier version.

# Platform support

Nitro Cookies targets native React Native apps on iOS, Android, and tvOS.
Android TV uses the Android implementation and still requires a working WebView provider for store operations.
Web and Expo Go do not provide this native module.

## Availability

| Capability                                   | iOS                              | tvOS                         | Android / Android TV                |
| -------------------------------------------- | -------------------------------- | ---------------------------- | ----------------------------------- |
| Default-store read, write, headers, deletion | Shared storage                   | Shared storage               | CookieManager; provider required    |
| `useWebKit: true`                            | Default WebKit store, async only | `WEBKIT_UNAVAILABLE`         | Flag ignored                        |
| List queries                                 | Stored metadata                  | Stored metadata              | URL lists: name/value only          |
| `getAll`, `getAllList`                       | Supported                        | Supported with default store | `PLATFORM_UNSUPPORTED`              |
| Scoped deletion                              | Exact stored identity            | Exact stored identity        | Expiration at caller-supplied scope |
| `getFromResponse`, `getFromResponseList`     | Native network request           | Native network request       | Native network request              |
| `flush`                                      | No-op                            | No-op                        | Persist CookieManager cookies       |
| `removeSessionCookies`                       | Resolves `false`, no removal     | Resolves `false`, no removal | Platform removal callback           |

The default Android minimum is API 24. Apple deployment requirements also depend on React Native and Nitro; do not infer app compatibility from WebKit's iOS 11 API availability.
The library podspec declares tvOS support, but your React Native tvOS version can require a newer target.

## Repository configurations

These are the versions configured in the current example and native fixtures, not a claim that every React Native version is compatible.
Check the corresponding CI result when assessing a platform change.

| Project                 | React Native                 | Nitro Modules | Other configuration                                   |
| ----------------------- | ---------------------------- | ------------- | ----------------------------------------------------- |
| iOS / Android example   | `0.85.3`                     | `0.35.9`      | `react-native-webview 13.16.1`; Android app minSdk 24 |
| iOS native fixture      | `0.85.3`                     | `0.35.9`      | XCTest through `test-apple.sh ios`                    |
| tvOS native fixture     | `react-native-tvos 0.85.3-3` | `0.35.9`      | XCTest through `test-tvos.sh`                         |
| Android instrumentation | Example dependencies         | `0.35.9`      | CI API 35, `google_apis`, x86_64                      |

The Android CI image is a phone image. Its unavailable-provider tests cover that failure path; they do not establish coverage on an Android TV system image.
The peer range is `react-native-nitro-modules >=0.35.0 <1.0.0`. The `react-native: *` peer declaration does not certify every React Native release.
Use an Expo development build containing the native packages. See [installation](https://l2hyunwoo.github.io/react-native-nitro-cookies/start/installation.md) and the [CI workflow](https://github.com/l2hyunwoo/react-native-nitro-cookies/blob/main/.github/workflows/ci.yml).

## Diagnose a missing cookie

1. Confirm that the native app was rebuilt after installing both packages.
2. Check the full URL, HTTPS requirement, domain, and request path.
3. Read and write from the same store on iOS.
4. On Android, confirm that a WebView provider is installed and enabled.
5. Use a list for duplicate names and retain the original Android scope.

An Android TV device without WebView does not gain a cookie backend from this package.
Handle `WEBVIEW_UNAVAILABLE` as a store-availability failure.

See [stores and scope](https://l2hyunwoo.github.io/react-native-nitro-cookies/concepts/storage.md) for behavior differences and [errors](https://l2hyunwoo.github.io/react-native-nitro-cookies/reference/errors.md) for recovery codes.
For symptom-based checks, follow [troubleshooting](https://l2hyunwoo.github.io/react-native-nitro-cookies/guides/troubleshooting.md).