# Firebase

> Firebase Admin API Skill

- Skill: `ashish7802/firebase` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add ashish7802/firebase`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ashish7802/firebase/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: ashish7802 (https://skillmd.com/u/ashish7802)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/ashish7802/firebase

---

# Firebase Admin API Skill

## Overview
Firebase Admin SDK allows privileged server environments to interact with Firestore, Auth, and Cloud Messaging.

## Installation
```bash
npm install firebase-admin
pip install firebase-admin
```

## Authentication
Authenticate using a Google Cloud Service Account key JSON file or Application Default Credentials (ADC).

## Core Concepts
- **Firestore**: NoSQL document database.
- **Custom Tokens**: JWTs minted on the server to log users into the client SDK.
- **FCM**: Firebase Cloud Messaging for push notifications.

## Common Workflows
1. Initialize `initializeApp({ credential: cert(serviceAccount) })`.
2. Access Firestore: `getFirestore()`.
3. Perform operations bypassing security rules.

## Error Handling
Catch `FirebaseError`. Error codes match RPC statuses (e.g., `not-found`, `already-exists`).

## Security
Service accounts have absolute God-mode access. Never deploy an Admin SDK service account key to a client application.

## Rate Limits
Firestore allows 10,000 writes per second per database. Batch operations are limited to 500 documents per batch.

## Best Practices
Use `batch()` for multiple writes to ensure atomicity. Use `runTransaction()` when a write depends on the current value of a document.

## Troubleshooting
If initialized multiple times, the SDK throws a 'default app already exists' error. Check `getApps().length` before initializing.

## References
- [API Reference](https://firebase.google.com/docs/admin/setup)

## Why use this skill
Use this when your agent works with **firebase** — structured patterns beat pasted docs and prevent common hallucinations.

## AI pitfalls
- Inventing column names or schema fields
- Using deprecated driver methods or wrong connection strings
- Omitting connection pooling or transaction boundaries

## Production checklist
- [ ] Migrations version-controlled and applied via CI
- [ ] Connection limits and pooling configured
- [ ] Backups and restore procedure documented

## Related skills
- No graph relationships yet — see the knowledge graph in the docs site.

---
> **Last Verified:** 2026-07-02