Firestore Complete Guide: Native vs Datastore Mode, Real-Time Sync, and Firebase Integration

Firestore is GCP's document-oriented NoSQL database, widely adopted as the backend for Mobile and Web applications. Its hallmarks are tight Firebase integration, real-time sync, offline support, and declarative access control via Security Rules.

The Two Modes

Data Model

• Collection: a set of documents (e.g. users)
• Document: a JSON-like object up to 1 MB in size
• Subcollection: a Collection nested under a Document
• Field: a property inside a document (String / Number / Array / Map / Reference / GeoPoint, etc.)

Query Capabilities

• Equality: where('status', '==', 'active')
• Range: where('age', '>=', 20) (one field only)
• Array contains: where('tags', 'array-contains', 'js')
• OR: where(Filter.or(a, b)) (since 2023)
• Composite Index: required for multi-field combinations (must be created in advance)
• Collection Group: queries that span subcollections
• Aggregation: count / sum / avg (since 2023)
• Vector Search: KNN queries (preview from 2024)

Pricing

Security Rules Example

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow read: if request.auth != null;
      allow write: if request.auth.uid == userId;
    }
    match /posts/{postId} {
      allow read: if true;
      allow create: if request.auth != null;
      allow update, delete: if request.auth.uid == resource.data.authorId;
    }
  }
}

Real-Time Sync

// JavaScript SDK
import { onSnapshot, doc } from "firebase/firestore";

const unsub = onSnapshot(doc(db, "chats", "room1"), (docSnap) => {
  console.log("Changes:", docSnap.data());
});
// Cleanup
unsub();

Comparison With Other NoSQL Stores

Typical Use Cases

• Mobile/Web app backends (Firebase-integrated)
• Chat and collaboration tools (real-time sync)
• User profile management
• E-commerce carts and orders (flexible structure via Subcollections)
• IoT device state management
• Product recommendations powered by Vector Search (since 2024)

Best Practices

• Cache hot reads on the client side
• Define Composite Indexes up front (detect them before deploy)
• Keep each document under the 1 MB limit
• Export large datasets to BigQuery for analytics
• Unit-test your Security Rules with @firebase/rules-unit-testing
• Use Firestore Bundles to accelerate initial data delivery

* Google Cloud and Firebase are trademarks of Google LLC. For the latest information, see the official Firestore docs.