docs: document @couchbase/couchbase-lite-react-native npm package

Add npm registry links, migration guidance for the legacy cbl-reactnative
package, release notes, and official repository metadata.

Author: jayant-dhingra-cb

docs/Guides/Migration/v1.1.md

@@ -16,6 +16,25 @@ Version 1.1 is focused on React Native New Architecture support and better troub
 2. **Improved file logging** - React Native wrapper diagnostics can be written to file and custom log sinks.
 3. **LogSinks.write()** - application code can write messages into configured Couchbase Lite log sinks.
 4. **Reliability fixes** - listener cleanup, document expiration, and conflict-aware deletes are improved.
+5. **Official npm package** - published as `@couchbase/couchbase-lite-react-native`, replacing the legacy `cbl-reactnative` package.
+
+## NPM Package Rename
+
+Version 1.1 is published on npm as [`@couchbase/couchbase-lite-react-native`](https://www.npmjs.com/package/@couchbase/couchbase-lite-react-native). The legacy unscoped package `cbl-reactnative` (1.0.1 and earlier) is superseded. New installs and upgrades should use the scoped package.
+
+| What to update | Before (`cbl-reactnative`) | After (`@couchbase/couchbase-lite-react-native`) |
+|---|---|---|
+| Install | `npm install cbl-reactnative` | `npm install @couchbase/couchbase-lite-react-native` |
+| TypeScript imports | `from 'cbl-reactnative'` | `from '@couchbase/couchbase-lite-react-native'` |
+| Android Gradle path | `node_modules/cbl-reactnative/android/build.gradle` | `node_modules/@couchbase/couchbase-lite-react-native/android/build.gradle` |
+| Expo plugin podspec path | `node_modules/cbl-reactnative/cbl-reactnative.podspec` | `node_modules/@couchbase/couchbase-lite-react-native/cbl-reactnative.podspec` |
+
+**Upgrade checklist:**
+
+1. Remove `cbl-reactnative` from `package.json`
+2. Install `@couchbase/couchbase-lite-react-native`
+3. Update all import paths and native wiring paths
+4. Rebuild native projects (`pod install`, Gradle clean build)
 
 ## TurboModule Support
 
@@ -73,5 +92,6 @@ await LogSinks.write(
 
 ## Repository Links
 
+- [@couchbase/couchbase-lite-react-native on npm](https://www.npmjs.com/package/@couchbase/couchbase-lite-react-native)
 - [couchbase/couchbase-lite-react-native](https://github.com/couchbase/couchbase-lite-react-native)
 - [couchbase/couchbase-lite-js-common](https://github.com/couchbase/couchbase-lite-js-common)

docs/ProductNotes/release-notes.md

@@ -23,6 +23,8 @@ Improvements and Fixes:
 - Android replicator filters can use JavaScript arrow functions in the V8 evaluation path.
 
 Repository Updates:
+- Official npm package: [@couchbase/couchbase-lite-react-native](https://www.npmjs.com/package/@couchbase/couchbase-lite-react-native)
+- The legacy `cbl-reactnative` package is superseded; new installs and upgrades should use the scoped package
 - Main React Native repository: [couchbase/couchbase-lite-react-native](https://github.com/couchbase/couchbase-lite-react-native)
 - Shared JavaScript library repository: [couchbase/couchbase-lite-js-common](https://github.com/couchbase/couchbase-lite-js-common)
 

docs/StartHere/install.md

@@ -22,12 +22,18 @@ The installation for the Native Module is provided in two sections:  one section
 
 ### React Native Based Apps 
 
-To use the Couchbase Lite React Native Native Module in a standard React Native app, you will need to install the npm package.  From the root of your applications project directory (the directory containing your `package.json` file), run the following command:
+To use the Couchbase Lite React Native Native Module in a standard React Native app, you will need to install the npm package [@couchbase/couchbase-lite-react-native](https://www.npmjs.com/package/@couchbase/couchbase-lite-react-native).  From the root of your applications project directory (the directory containing your `package.json` file), run one of the following commands:
 
 ```bash
 npm install @couchbase/couchbase-lite-react-native
+# or
+yarn add @couchbase/couchbase-lite-react-native
 ```
 
+:::note
+New projects should install the scoped package above. Upgrading from the legacy `cbl-reactnative` package (1.0.1 and earlier)? See the [Version 1.1 Migration Guide](../Guides/Migration/v1.1.md#npm-package-rename).
+:::
+
 Once installed, you will want to build each native project (iOS and Android) to link the native module to your project.  
 
 #### iOS

docs/StartHere/prerequisties.md

@@ -7,7 +7,7 @@ sidebar_position: 1
 
 Couchbase Lite for React Native is provided as a [Native Module](https://reactnative.dev/docs/legacy/native-modules-intro). Version 1.1 supports [React Native New Architecture](https://reactnative.dev/architecture/overview) through TurboModules on iOS and Android.
 
-The Native Module can be found at the following repository: [Couchbase Lite for React Native](https://github.com/couchbase/couchbase-lite-react-native). Shared TypeScript and JavaScript code lives in [cblite-js](https://github.com/couchbase/couchbase-lite-js-common).
+The Native Module can be found at the following repository: [Couchbase Lite for React Native](https://github.com/couchbase/couchbase-lite-react-native). npm package: [@couchbase/couchbase-lite-react-native](https://www.npmjs.com/package/@couchbase/couchbase-lite-react-native). Shared TypeScript and JavaScript code lives in [cblite-js](https://github.com/couchbase/couchbase-lite-js-common).
 
 A developer using this plugin should have a basic understanding of the following technologies:
 - [React Native](https://reactnative.dev/)

docs/intro.md

@@ -22,6 +22,8 @@ More information on React Native - Native Modules can be found here: [React Nati
 Couchbase Lite for React Native has officially graduated from a community project to a fully Enterprise-Supported offering
 :::
 
+Install via npm: [@couchbase/couchbase-lite-react-native](https://www.npmjs.com/package/@couchbase/couchbase-lite-react-native) — see [Install](StartHere/install.md) for full setup.
+
 The version of this Native Module is based on supporting Couchbase Lite Enterprise for iOS and Android.  A [license](https://www.couchbase.com/pricing/) is required to use Couchbase Lite Enterprise edition.  
 
 ## Features

docusaurus.config.js

@@ -187,6 +187,10 @@ const config = {
                 label: 'GitHub',
                 href: 'https://github.com/couchbase/couchbase-lite-react-native',
               },
+              {
+                label: 'npm',
+                href: 'https://www.npmjs.com/package/@couchbase/couchbase-lite-react-native',
+              },
             ],
           },
         ],

package.json

@@ -2,6 +2,14 @@
   "name": "cbl-reactnative",
   "version": "1.0.1",
   "private": true,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/couchbase/cbl-reactnative-docs.git"
+  },
+  "homepage": "https://cbl-reactnative.dev/",
+  "bugs": {
+    "url": "https://github.com/couchbase/cbl-reactnative-docs/issues"
+  },
   "scripts": {
     "docusaurus": "docusaurus",
     "start": "docusaurus start",