apache /pouchdb
:kangaroo: - PouchDB is a pocket-sized database.
★ 17,631⑂ 1,508👁 254⑃ 4,861● 4,377▤ 69
+0
日增长
17,631
stars
1,508
forks
254
watchers
4,861
prs
4,377
issues
69
releases
README
Apache PouchDB – The Database that Syncs!
Apache PouchDB is an open-source JavaScript database inspired by Apache CouchDB that is designed to run well within the browser.
PouchDB was created to help web developers build applications that work as well offline as they do online.
Apache PouchDB is currently undergoing Incubation at the Apache Software Foundation. Read the ASF Disclaimer for incubator projects.
Using PouchDB
To get started using PouchDB, check out the web site and API documentation.
Getting Help
The PouchDB community is active in pouchdb on the CouchDB Slack, in the Google Groups mailing list, and on StackOverflow. Or you can mastodon @pouchdb!
If you think you've found a bug in PouchDB, please write a reproducible test case and file a Github issue.
Prerelease builds
If you like to live on the bleeding edge, you can build PouchDB from source using these steps:
git clone https://github.com/pouchdb/pouchdb.git
cd pouchdb
npm install
After running these steps, the browser build can be found in packages/node_modules/pouchdb/dist/pouchdb.js.
Changelog
PouchDB follows semantic versioning. To see a changelog with all PouchDB releases, check out the Github releases page.
For a concise list of breaking changes, there's the wiki list of breaking changes.
Keep in mind that PouchDB is auto-migrating, so a database created in 1.0.0 will still work if you open it in 4.0.0+. Any release containing a migration is clearly marked in the release notes.
Contributing
We're always looking for new contributors! If you'd like to try your hand at writing code, writing documentation, designing the website, writing a blog post, or answering questions on StackOverflow, then we'd love to have your input.
If you have a pull request that you'd like to submit, please read the contributing guide for info on style, commit message format, and other (slightly!) nitpicky things like that. PouchDB is heavily tested, so you'll also want to check out the testing guide.
The pouchdb.com Website
The documentation website at pouchdb.com is also part of this repo, in the /docs folder. It has its own /docs/WEBSITE_README.md
Website deployment happens automatically once the changes land in master.Top issues
#8209indexeddb adapter can break when opened in multiple tabs33 comments · 2020-10-08#3234Duplicate attachments for doc update (& putAttachment)23 comments · 2014-12-22#8754PouchDB in Nextjs throws error16 comments · 2023-09-16#8383PouchDB Adapter Memory is broken on Jest 27.x due to removal of setImmediate15 comments · 2021-10-19#8534pouchdb-find, $or and multiple $regex conditions and nested properties9 comments · 2022-07-25#8544Buffer type declaration from Node conflicts with the PouchDB one8 comments · 2022-09-15#8535TypeError issue in the browser with `Object` being undefined (SSR with vite)8 comments · 2022-07-29#9111Very large update requests trigger failure to sync due to revsDiff failure7 comments · 2025-08-21
Discussions
#9114Created a sqlite adapter for nodejs0 comments · 2025-09-03#9077Case insensitive sorting for db.find(request) result set1 comments · 2025-03-11#9070Best practice subscription/observable in sveltekit1 comments · 2025-02-20#9059[question] How to use the pouchDB in react?0 comments · 2025-01-22#9021tanksThank you pouchdb0 comments · 2024-12-09#9008Getting the lastCheckpointdoc.seq before starting the replication1 comments · 2024-11-27#8964Is it possible to allow conflicting revisions be synced on replication pull but disallowed on push?0 comments · 2024-06-20#8879Issue in setting-up pouchdb in my Vite-react application.1 comments · 2024-03-15
Latest release
9.0.0 9.0.0 2024-06-21The PouchDB developers are delighted to announce the immediate availability of PouchDB 9.0.0. This is a major release with 202 PRs merged since the last version. For a full changelog from 8.0.1 to 9.0.0, please see the releases page or view the latest commits. The PouchDB developers would like to thank all contributors for their hard and diligent work. Highlights - Massively improved the stability and performance of the indexeddb adapter. Special thanks to @alxndrsn, Medic, and the Google Advanced Web Apps Fund. - Introduce a default limit (of 25) to the .find() method. This cons