PouchDB
pouchdb.apache.org
- Free plan
- Open source
- Windows
- Linux
- Web
- iPhone and iPad
- Android
- Browser extension
- API
- Self-hosted
What PouchDB is
PouchDB is a free, open-source JavaScript database inspired by Apache CouchDB and designed for browser applications. It stores data locally so applications can keep working offline, then synchronize in both directions with CouchDB-compatible servers when online. The same API works in browsers and Node.js. Browser storage uses IndexedDB by default, and the project documents a native SQLite adapter for Node.js versions later than 22.5.0. Supported server connections include CouchDB 1.x, 2.x, and 3.x, Cloudant, and PouchDB Server. PouchDB is framework-agnostic, with Angular, React, Ember, and Backbone among the examples named by the project. It can also run with Cordova/PhoneGap, NW.js, Electron, and Chrome apps. Documents must be serializable as JSON; attachments can be supplied as base64-encoded strings or Blob objects. Direct synchronization with a non-CouchDB database requires that backend to speak the CouchDB replication protocol. The project lists GitHub Discussions, Slack, and Stack Overflow for discussion and says Apache PouchDB is undergoing incubation at the Apache Software Foundation.
Who it suits
PouchDB suits JavaScript developers building browser or Node.js applications that need local data and synchronization with a CouchDB-compatible server. It can also fit projects using the named JavaScript frameworks or mobile and desktop environments.
Good to know, and what to watch
- Works offline with local data storage.
- Synchronizes in both directions with compatible servers.
- Uses the same API in browsers and Node.js.
- Browser storage defaults to IndexedDB.
- Free and open source.
- Non-CouchDB backends need the replication protocol for direct sync.
- Documents must be serializable as JSON.
- Mobile Safari has a hard 50MB WebSQL limit.
Plans
Every plan and priceFree
Free open-source project
Free plan
Getting started
- Open the PouchDB website
- Add the JavaScript database to a browser or Node.js application
- Use IndexedDB by default in browsers
- Choose a documented Node.js adapter when applicable
- Connect to a CouchDB-compatible server for synchronization
Limits to check
Direct synchronization is limited to backends that speak the CouchDB replication protocol. Mobile Safari has a hard 50MB WebSQL limit, while Cordova or PhoneGap can use unlimited data with a SQLite plugin.
The verdict
PouchDB offers local storage and bidirectional synchronization for JavaScript applications across browsers and Node.js. Its direct sync depends on CouchDB compatibility, and the project says it is undergoing Apache Software Foundation incubation.
Questions people ask
Is PouchDB free?
Yes. PouchDB is a free, open-source project with a free plan priced at no cost open-source project.
Which environments does PouchDB support?
It runs in browsers and Node.js, with platforms including Android, iOS, web, Windows, extensions, APIs, and self-hosted deployments.
Can PouchDB work offline?
Yes. It stores data locally and synchronizes bidirectionally with compatible servers when connectivity returns.
Which servers can it synchronize with?
The documentation names CouchDB 1.x, 2.x, and 3.x, Cloudant, and PouchDB Server.
What data formats are supported?
Documents must be serializable as JSON. Attachments can be base64-encoded strings or Blob objects.
What the maker publishes
- Asynchronous API
- The public API supports callbacks, promises and async functions. source
- Browser preset
- The pouchdb-browser preset includes IndexedDB plus replication, HTTP and map/reduce plugins. source
- Browser storage
- PouchDB uses IndexedDB by default in browsers and prefers IndexedDB over separately installed WebSQL support. source
- Build tooling
- Custom builds require an npm-oriented bundler such as Browserify, Webpack, Rollup, SystemJS or JSPM; direct prebuilt-file workflows are not supported for custom builds. source
- Community support
- The project points users to GitHub issues, Slack, mailing lists and Stack Overflow for help. source
- Company founded
- LinkedIn lists The Apache Software Foundation as founded in 1999. source
- Company headquarters
- The Apache Software Foundation lists its mailing address in Wilmington, Delaware, United States. source
- Company legal entity
- The Apache Software Foundation is a U.S. 501(c)(3) nonprofit organization and the listed steward of Apache PouchDB. source
- Company size
- LinkedIn lists the Apache Software Foundation in the 5,001–10,000 employee size range. source
- Compatibility limit
- PouchDB cannot sync directly with a non-CouchDB database unless the backend speaks the CouchDB replication protocol. source
- CouchDB compatibility
- The project aims to closely reproduce the CouchDB API and replication behavior. source
- Custom builds
- Packages can be assembled from presets, plugins and utilities to reduce bundle size or tailor functionality. source
- Data formats
- PouchDB stores documents that must be serializable as JSON and supports attachments supplied as base64-encoded strings or Blob objects. source
- Documentation depth
- Official materials include a getting-started tutorial, API reference, guides, FAQ, adapter documentation and plugin listings. source
- Document operations
- The API includes database creation, document insertion and updates, deletion, bulk operations and changes feeds. source
- Environments
- PouchDB runs in browsers and Node.js, and its API works the same across those environments. source
- Frameworks
- The project says it is framework-agnostic and can be used with Angular, React, Ember, Backbone, or another framework. source
- License
- PouchDB is distributed under the Apache License 2.0. source
- Limit: Analytics workload
- DEV.co advises against using PouchDB for high-volume real-time analytics or warehouse-scale aggregation. source
- Limit: Conflict handling
- DEV.co says applications must define how concurrent replication conflicts are resolved or merged. source
- Limit: Query performance
- The official performance report says secondary-index construction is expensive and recommends other databases for complex queries or large datasets when synchronization is unnecessary. source
- Limit: Storage-engine variability
- The official performance report documents materially different performance across IndexedDB, WebSQL, LevelDB and memory adapters. source
- Limit: Transaction model
- DEV.co warns that PouchDB follows eventual consistency rather than providing strict ACID multi-document transactions. source
- Local storage adapters
- Browser databases use IndexedDB, older browsers may use WebSQL, and Node.js uses LevelDB by default. source
Checked against the maker's pages on 15 Oct 2026.