Couchbase Lite for React Native Release Notes

1.1.1 — October 2026

Version 1.1.1 for React Native delivers the following features and enhancements:

None for this release

None for this release

None for this release

Version 1.1.0 for React Native delivers the following features and enhancements:

Official React Native New Architecture / TurboModule support for iOS and Android native modules.
Improved file logging: React Native wrapper diagnostics can now be forwarded into configured file and custom log sinks.
React Native-originated log lines are prefixed with RN ::LEVEL:: so they are easy to distinguish from native Couchbase Lite log output.
LogSinks.write() API for writing app-authored messages into the Couchbase Lite logging pipeline.
FileSystem.getFilesInDirectory(path) API for listing files in a directory, useful when discovering generated log files.

Updated Couchbase Lite Android and iOS Enterprise SDKs to 3.3.3.
Improved listener reliability for collection, query, and replicator events on the New Architecture event path.
Replicator event payloads now include error fields where applicable.
Document expiration handling now supports clearing expiration with null and uses stricter UTC ISO-8601 parsing.
Delete operations using ConcurrencyControl.FAIL_ON_CONFLICT now honor revision IDs more consistently.
Android replicator filters can use JavaScript arrow functions in the V8 evaluation path.

Official npm 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
Shared JavaScript library repository: couchbase/couchbase-lite-js-common

Existing application-level APIs remain largely compatible.
Enable React Native New Architecture to use the TurboModule implementation.
Review logging setup if you want React Native wrapper logs included in file or custom log sinks.

See Migration Guide for detailed instructions.

Version 1.0.0 for React Native delivers the following features and enhancements:

Log Sink API - Console, File, and Custom log sinks with configurable levels and domains
LogDomain.ALL - New domain to enable all log categories at once
Listener Token Management - New ListenerToken class with token.remove() API
Collection Change Listeners - Monitor all documents in a collection
Document Change Listeners - Monitor specific documents by ID
Query Change Listeners (Live Queries) - Real-time query results
Replicator Status Change Listeners - Monitor replication state and progress
Replicator Document Change Listeners - Track individual document replication
New ReplicatorConfiguration API - Collections passed during initialization using CollectionConfiguration
Collection.fullName() method - Get fully qualified collection name (scope.collection)
Couchbase Lite 3.3.0 - Updated iOS and Android SDKs to Couchbase Lite 3.3.0

TypeScript: ListenerToken type changed from string to ListenerToken object (affects explicitly typed code only)

These APIs remain available for backward compatibility:

Database.setLogLevel() - Use LogSinks.setConsole() instead. Note: Old and new logging APIs cannot be used in tandem.
config.addCollection(collection) - Pass CollectionConfiguration array in constructor instead
removeChangeListener() methods - Use token.remove() instead
ListenerToken type changed from string to ListenerToken object (TypeScript breaking change for explicitly typed code)

Replace Database.setLogLevel() with LogSinks.setConsole() (required - APIs cannot be mixed)
Update ReplicatorConfiguration to use new constructor pattern (recommended)
Update listener cleanup to use token.remove() (recommended)
Update TypeScript code that explicitly typed tokens as string to use ListenerToken (required for TypeScript)

See Migration Guide for detailed instructions.