# @firebase/firestore

> The Cloud Firestore component of the Firebase JS SDK.

Latest version **4.17.2** (published 2026-09-09) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @firebase/firestore
pnpm add @firebase/firestore
yarn add @firebase/firestore
bun add @firebase/firestore
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 4.17.2 |
| Published | 2026-09-09 |
| First published | 2017-10-11 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20.0.0 |
| Dependencies | 8 |
| Unpacked size | 58 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 5141 |
| Author | Firebase |
| Maintainers | firebase-ops, feiyang.chen, google-wombot, chholland |

## Links

- npm: https://www.npmjs.com/package/@firebase/firestore
- Repository: https://github.com/firebase/firebase-js-sdk
- Homepage: https://github.com/firebase/firebase-js-sdk#readme
- Issues: https://github.com/firebase/firebase-js-sdk/issues
- npm.io page: https://npm.io/package/@firebase/firestore

## Dependencies (8)

- [re2js](https://npm.io/package/re2js.md) ^2.8.3
- [tslib](https://npm.io/package/tslib.md) ^2.1.0
- [@grpc/grpc-js](https://npm.io/package/@grpc/grpc-js.md) ~1.9.0
- [@firebase/util](https://npm.io/package/@firebase/util.md) 1.15.3
- [@firebase/logger](https://npm.io/package/@firebase/logger.md) 0.5.2
- [@grpc/proto-loader](https://npm.io/package/@grpc/proto-loader.md) ^0.7.8
- [@firebase/component](https://npm.io/package/@firebase/component.md) 0.7.5
- [@firebase/webchannel-wrapper](https://npm.io/package/@firebase/webchannel-wrapper.md) 1.0.7

## Recent versions

- 4.17.2 (latest) — 2026-09-09
- 4.17.0-eap-crashlytics.e21972d2a (eap-crashlytics) — 2026-09-11
- 4.17.2-20260909154321 (next) — 2026-09-09
- 4.13.0-canary.bfb9accdc (canary) — 2026-04-01
- 4.9.2-caching-fdc.9f17eac6e (caching-fdc) — 2025-12-16
- 4.9.2-eap-firestore-pipelines.2.e4cdd2e06 (eap-firestore-pipelines) — 2025-11-06
- 4.9.0-firebase-studio-sdk-integration.556d1bed2 (firebase-studio-sdk-integration) — 2025-08-13
- 4.7.12-eap-ai-hybridinference.58d92df33 (eap-ai-hybridinference) — 2025-05-28
- 4.7.10-eap-vertexai-hybgoog.31261ca31 (eap-vertexai-hybgoog) — 2025-04-29
- 4.7.10-auth-redirect-credentials.b424e5897 (auth-redirect-credentials) — 2025-04-25
- 4.7.10-ssl-check.4f23f3343 (ssl-check) — 2025-04-23
- 4.7.10-eap-vertexai-hybridinference.e83974308 (eap-vertexai-hybridinference) — 2025-04-23
- 4.7.2-vertexai-preview.6b035b7d3 (vertexai-preview) — 2024-09-27
- 4.6.4-dataconnect-preview.d986d4bf2 (dataconnect-preview) — 2024-07-31
- 4.6.3-eap-firestore-backfiller.87babf60c (eap-firestore-backfiller) — 2024-06-25
- … 3964 more at https://npm.io/package/@firebase/firestore/versions

## README

# @firebase/firestore

This is the [Cloud Firestore](https://firebase.google.com/docs/firestore/) component of the
[Firebase JS SDK](https://www.npmjs.com/package/firebase).

**This package is not intended for direct usage, and should only be used via the officially
supported [firebase](https://www.npmjs.com/package/firebase) package.**

If you are developing a Node.js application that requires administrative access to Cloud Firestore,
use the [`@google-cloud/firestore`](https://www.npmjs.com/package/@google-cloud/firestore) Server
SDK with your developer credentials.

## Documentation

For comprehensive documentation please see the [Firebase Reference
Docs][reference-docs].

[reference-docs]: https://firebase.google.com/docs/reference/js/

## Contributing
See [Contributing to the Firebase SDK](../../CONTRIBUTING.md) for general
information about contributing to the firebase-js-sdk repo and
[Contributing to the Cloud Firestore Component](./CONTRIBUTING.md) for
details specific to the Cloud Firestore code and tests.

---
_Source: https://npm.io/package/@firebase/firestore · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._