#Release readiness

React Native Nitro Geolocation 2.0 is the stable release line. Validate the exact devices, native dependencies, and features your application ships.

#Release policy

• Stable 2.x releases preserve the documented public contracts; incompatible changes require a new major version.
• Pin exact dependency versions and retain your application's release evidence.
• The default site documents 2.x. The 1.x snapshot remains under /v1/.
• A stable package is staged under ga-candidate until matching native release artifacts pass verification and the release is promoted to latest.

Pin the repository's current reference combination:

yarn add react-native-nitro-modules@0.35.10 react-native-nitro-geolocation@2.0.1

#Declared support

Declared support is the package contract, not a claim that every possible combination is continuously exercised.

#Tested reference stack

The 2.0.1 repository currently builds and runs its consumer contracts with this reference stack. This is evidence of the continuously exercised path, not the full peer range.

Reference last reviewed for 2.0.1 on 2026-09-10. Consult the current example package and E2E workflow if this page and the installed release differ.

#Known limits

• Expo Go cannot load the native Nitro bindings.
• SwiftPM-only iOS is experimental on React Native 0.87.x and requires Nitro Modules 0.37.1 plus the documented app configuration helper.
• Browser builds support foreground geolocation only. The /background web entry is import-safe but reports unsupported behavior.
• Background delivery is best effort. Termination, reboot, iOS suspension, Android OEM restrictions, permission changes, and device settings affect what can be delivered. Read the reliability contract.
• Prebuilt fallback can turn an install into a source build. Validate both the selected artifact path and your CI's native build prerequisites.
• Geocoding and heading have platform/provider constraints; offline GPS does not imply offline geocoding. See the GPS/offline recipe.
• The library does not choose your battery/accuracy policy. Validate intervals, distance filters, accuracy, retention, and disclosure against the product use case and target devices.

Track newly reported release issues in GitHub Issues.

#Ship checklist

• Exact Geolocation, Nitro Modules, React Native, and Expo versions are locked and recorded in release evidence.
• nitro-geolocation doctor passes after native project generation.
• The app handles foreground grant, approximate/reduced grant, denial, restriction, settings changes, timeout, and provider unavailability.
• Current, cached, and watched positions are tested according to the product's freshness and accuracy rules.
• Every enabled background feature passes on physical devices and target OS versions; unsupported OS lifecycle claims are not shown to users.
• Background event recovery and server processing are idempotent.
• Only permissions required by enabled features are declared and requested at a user-understandable moment.
• Location retention, deletion, backup, sync, credentials, store disclosures, and incident handling pass the privacy review.
• Release-build consumer flows cover the product's critical path; use the consumer E2E contract kit as a baseline.
• Support reports can include the evidence in Troubleshooting without exposing precise user coordinates or credentials.
• A rollback build and any persistent-data compatibility strategy have been tested before rollout.

For 1.x applications, complete Upgrade from 1.x before using this checklist as the final release gate.