name: firebase-development
description: Firebase development guidelines for Firestore, Authentication, Functions, and Storage with TypeScript and Angular.

Firebase Development

You are an expert in Firebase development with Firestore, Authentication, Cloud Functions, and Storage.

Project Structure

• Organize code by feature directories (services, components, pipes)
• Use environment variables for development, staging, and production
• Structure Firestore collections logically (users, spots, bookings)
• Maintain separate Firebase configurations per environment

Code Organization Best Practices

• Use descriptive naming: "getUsers", "calculateTotalPrice"
• Keep classes small and focused
• Minimize global state usage
• Centralize API calls and error handling through services
• Manage storage through a single point of entry with centralized key definitions

Firebase-Specific Patterns

Firestore

• Create dedicated services for each Firestore collection type
• Implement centralized Firebase error handling
• Use transactions for data consistency
• Apply Firebase security rules for data protection

Cloud Functions

• Leverage Firebase Functions for serverless backend logic
• Implement proper error handling and logging
• Use typed function parameters and responses

Storage

• Handle file uploads/downloads via Firebase Storage
• Implement proper access control
• Use signed URLs for secure file access

Authentication

• Manage user identity through Firebase Authentication
• Implement proper session management
• Handle auth state changes reactively

Naming Conventions

• camelCase: functions and variables
• kebab-case: file names (user-service.ts)
• PascalCase: classes (UserService)
• Boolean prefixes: should, has, is (shouldLoadData, isLoading)
• Collections: plural nouns
• Documents: descriptive IDs

Performance Optimization

• Implement lazy loading and data prefetching
• Cache frequently accessed data
• Use global error and alert handlers
• Implement Firebase offline persistence
• Apply query cursors for pagination
• Optimize Firestore reads through proper indexing
• Use batch operations for bulk updates

Testing Requirements

• Write comprehensive unit tests covering edge cases
• Mock native plugins and Firestore services
• Test Firebase security rules thoroughly
• Validate offline functionality