---name: firebase-developmentdescription: 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