---
title: Version 1.1
pubDate: 2026-10-03T04:27:21.374Z
meta:
  component:
    title: Couchbase Lite React Native
    version: "1.1"
antora:
  editUrl: https://github.com/couchbaselabs/docs-couchbase-lite-react-native/edit/release/1.1/modules/guides/pages/migration/v1.1.adoc
  xref: xref:cbl-reactnative:guides:migration/v1.1.adoc[]
---

[Consult the llms.txt file for a full list of contents](/llms.txt)
[View original HTML](/cbl-reactnative/current/guides/migration/v1.1.html)

# Version 1.1

> Description - _Quick reference for customer-facing changes in @couchbase/couchbase-lite-react-native version 1.1_  
> Related Content - [Release Notes](../../product-notes/release-notes.md) | [Using Logs](../../troubleshooting/using-logs.md)

## [](#at-a-glance)At a Glance

Version 1.1 is focused on React Native New Architecture support and better troubleshooting:

1. **TurboModules** \- iOS and Android modules now support the React Native New Architecture.
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)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)TurboModule Support

Version 1.1 supports [React Native New Architecture](https://reactnative.dev/architecture/overview) through TurboModules. Existing application-level Couchbase Lite APIs remain largely compatible, but New Architecture should be enabled to use the TurboModule implementation.

For Expo development builds, enable New Architecture in `app.json`:

```json
{
  "expo": {
    "newArchEnabled": true
  }
}
```

For React Native Android projects, make sure `newArchEnabled=true` is set in the Android project configuration.

## [](#logging-changes)Logging Changes

### [](#react-native-logs-in-file-and-custom-sinks)React Native Logs in File and Custom Sinks

When a file or custom log sink is enabled, version 1.1 can forward React Native wrapper diagnostics into the same logging pipeline as native Couchbase Lite logs.

React Native-originated lines are prefixed with `RN`:

```text
RN ::DEBUG:: database_Open
RN ::WARNING:: query_RemoveChangeListener rejected: no listener for token
RN ::ERROR:: collection_Save failed
```

This helps diagnose issues that cross the JavaScript/native boundary while keeping sensitive payloads out of forwarded logs.

### [](#writing-application-logs)Writing Application Logs

Use `LogSinks.write()` to write application messages into configured Couchbase Lite sinks:

```typescript
import { LogSinks, LogLevel, LogDomain } from '@couchbase/couchbase-lite-react-native';

await LogSinks.write(
  LogLevel.WARNING,
  LogDomain.DATABASE,
  'Retrying database open after transient failure'
);
```

## [](#smaller-behavior-improvements)Smaller Behavior Improvements

* Passing `null` to `setDocumentExpiration()` clears a document expiration.
* Delete operations using `ConcurrencyControl.FAIL_ON_CONFLICT` reject stale revisions more consistently.
* Query, collection, and replicator listener routing is more consistent on New Architecture builds.
* Android replication filters support JavaScript arrow functions.
* `FileSystem.getFilesInDirectory(path)` can list generated log files.

## [](#repository-links)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)