Jeremy Firestore

Production-ready Firebase/Firestore operations for Claude Code

Build, manage, and optimize Firebase/Firestore databases with AI-powered agents that handle CRUD operations, security rules, batch processing, migrations, and performance monitoring.

Features

Core Capabilities

• CRUD Operations - Create, read, update, delete with batch support
• Security Rules - Generate, validate, and deploy Firestore security rules
• Data Migration - Migrate data between collections, projects, or environments
• Batch Operations - Process thousands of documents efficiently
• Cost Optimization - Analyze and reduce Firebase costs
• Performance Monitoring - Track queries, indexes, and bottlenecks
• Cloud Functions Integration - Trigger and manage Cloud Functions
• Collection Management - Schema validation, indexing, and organization

AI Agents

• firebase-operations-agent - CRUD, queries, batch operations
• firestore-security-agent - Security rules generation and validation
• firestore-migration-agent - Data migration and transformation
• firestore-optimizer-agent - Performance and cost optimization

Commands

• /firestore-setup - Initialize Firebase SDK and credentials
• /firestore-query - Interactive query builder
• /firestore-migrate - Guided migration workflow

Quick Start

Installation

# Install the plugin
/plugin install jeremy-firestore@claude-code-plugins-plus

# Initialize Firebase in your project
/firestore-setup

Prerequisites

1. Firebase Project - Create at https://console.firebase.google.com
2. Service Account - Download JSON key from Project Settings > Service Accounts
3. Node.js - Version 18+ with npm/pnpm/yarn

First-Time Setup

# 1. Install Firebase Admin SDK
npm install firebase-admin

# 2. Set environment variable
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/serviceAccountKey.json"

# 3. Run setup command
/firestore-setup

Usage Examples

Example 1: CRUD Operations

// Create documents
"Create a new user document in the 'users' collection"

Agent creates:
{
  uid: "user123",
  email: "[email protected]",
  createdAt: Timestamp.now(),
  role: "user"
}

// Read with queries
"Get all users created in the last 7 days"

Agent executes:
db.collection('users')
  .where('createdAt', '>=', sevenDaysAgo)
  .orderBy('createdAt', 'desc')
…

Example 2: Security Rules

# Generate security rules for a users collection
"Create security rules for the users collection where:
- Users can read their own document
- Only admins can write
- Email field is required and must be a valid email"

Agent generates:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      // Users can read their own document
      allow read: if request.auth != null && request.auth.uid == userId;

      // Only admins can write
      allow write: if request.auth != null &&
                      get(/databases/$(database)/documents/users/$(request.auth.uid)).data.role == 'admin';

      // Validation
      allow create, update: if request.resource.data.email is string &&
                               request.resource.data.email.matches('^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$');
    }
  }
}

Example 3: Data Migration

# Migrate data between environments
"Migrate all users from staging to production, but anonymize email addresses"

Agent workflow:

1. Connects to staging - Reads source collection
2. Transforms data - Anonymizes PII fields
3. Validates - Checks schema compatibility
4. Batch writes - Writes to production in chunks of 500
5. Verifies - Confirms document counts match
6. Reports - Shows migration summary

Example 4: Batch Operations

# Update 10,000 documents efficiently
"Add a 'verified: false' field to all users who registered before 2024"

Agent executes:

• Queries in batches of 500 documents
• Uses batch writes for efficiency (reduces costs 10x)
• Handles rate limits automatically
• Shows progress updates
• Reports total documents updated

Example 5: Performance Optimization

# Analyze slow queries
"Analyze the performance of my Firestore queries and suggest optimizations"

Agent analyzes:

• Missing indexes - Identifies composite indexes needed
• Query patterns - Finds inefficient queries
• Collection structure - Suggests denormalization opportunities
• Read/write costs - Calculates monthly costs