Firebase Setup

Firebase Services Overview

Missão uses the following Firebase services:

Step 1: Create a Firebase Project

1. Go to Firebase Console
2. Click "Add project" or "Create a project"
3. Enter your project name (e.g., "my-church-app")
4. Accept the terms and continue
5. Enable or disable Google Analytics (recommended: enable)
6. If enabling Analytics, select or create a Google Analytics account
7. Click "Create project"

Step 2: Enable Authentication

1. In Firebase Console, go to Build → Authentication
2. Click "Get started"
3. Enable the following sign-in providers:

Email/Password

1. Click on "Email/Password"
2. Toggle "Enable" to ON
3. Optionally enable "Email link (passwordless sign-in)"
4. Click "Save"

Google Sign-In

1. Click on "Google"
2. Toggle "Enable" to ON
3. Add a support email address
4. Click "Save"

Apple Sign-In (for iOS)

1. Click on "Apple"
2. Toggle "Enable" to ON
3. Configure your Apple Developer credentials:
   • Services ID
   • Apple Team ID
   • Key ID and Private Key
4. Click "Save"

Step 3: Set Up Firestore Database

1. Go to Build → Firestore Database
2. Click "Create database"
3. Choose "Start in production mode"
4. Select your database location:
   • Brazil: southamerica-east1 (São Paulo)
   • US: us-central1
   • Europe: europe-west1
5. Click "Enable"

Deploy Security Rules

The project includes pre-configured security rules. Deploy them with:

firebase deploy --only firestore:rules

Firestore Collections Structure

Step 4: Set Up Cloud Storage

1. Go to Build → Storage
2. Click "Get started"
3. Choose "Start in production mode"
4. Select the same location as your Firestore database
5. Click "Done"

Deploy Storage Rules

firebase deploy --only storage

Storage Structure

gs://your-project.appspot.com/
├── parishes/
│   └── {parishId}/
│       ├── photos/       # Parish photos
│       └── logo/         # Parish logo
├── users/
│   └── {userId}/
│       └── avatar/       # User profile picture
└── events/
    └── {eventId}/
        └── images/       # Event images

Step 5: Deploy Cloud Functions

Upgrade to Blaze Plan

Cloud Functions require the Blaze (pay-as-you-go) plan:

1. Click the ⚙️ gear icon in the Firebase Console
2. Select "Usage and billing"
3. Click "Modify plan"
4. Select "Blaze" and add a billing account

Deploy Functions

# Navigate to project root
cd ~/projects/missao

# Deploy all functions
firebase deploy --only functions

Available Cloud Functions

Step 6: Configure Cloud Messaging (FCM)

iOS Configuration

1. Generate an APNs key in Apple Developer Console
2. Go to Firebase Console → Project Settings → Cloud Messaging
3. Under "Apple app configuration", upload your APNs key

Android Configuration

Android is configured automatically when you add google-services.json to your project.

Web Configuration

Generate a VAPID key for web push notifications:

1. Go to Project Settings → Cloud Messaging
2. Under "Web configuration", click "Generate key pair"
3. Copy the key and add it to your environment configuration

Step 7: Set Up Firebase Hosting

Configure hosting targets for the Admin Panel:

# Add hosting target for admin panel
firebase target:apply hosting admin YOUR_PROJECT_ID

# Deploy (after building)
flutter build web --dart-define-from-file=.env.prod
firebase deploy --only hosting:admin

The firebase.json already includes the hosting configuration with:

• SPA rewrites (all routes → index.html)
• Cache headers for assets
• Hosting targets for admin and widgetbook

Step 8: Install Extensions (Optional)

Trigger Email Extension

For sending emails (admin invitations, password resets):

1. Go to Extensions in Firebase Console
2. Search for "Trigger Email"
3. Click "Install"
4. Configure with your SMTP provider (SendGrid recommended):

   SMTP_CONNECTION_URI=smtps://apikey:YOUR_API_KEY@smtp.sendgrid.net:465
   MAIL_COLLECTION=mail
   DEFAULT_FROM=noreply@yourdomain.com

Step 9: Configure FlutterFire

Run FlutterFire CLI to generate platform configurations:

# Ensure FlutterFire CLI is installed
dart pub global activate flutterfire_cli

# Configure Firebase
flutterfire configure --project=YOUR_PROJECT_ID

This generates:

• lib/firebase_options.dart - Dart configuration
• android/app/google-services.json - Android configuration
• ios/Runner/GoogleService-Info.plist - iOS configuration

Step 10: Create First Admin User

After deploying Cloud Functions, create your first admin:

Option 1: Using Firebase Console

1. Go to Authentication → Users
2. Add a new user with email/password
3. Go to Firestore → admins collection
4. Create a document with the user's UID:

{
  "uid": "USER_UID_HERE",
  "email": "admin@example.com",
  "displayName": "Super Admin",
  "role": "super_admin",
  "status": "active",
  "createdAt": Timestamp,
  "createdBy": "system"
}

Option 2: Using Firebase CLI

# This requires a custom script (included in functions/scripts/)
node functions/scripts/create-admin.js --email=admin@example.com --role=super_admin

Firebase Emulators (Development)

For local development, use Firebase Emulators:

# Start all emulators
firebase emulators:start

# Start specific emulators
firebase emulators:start --only auth,firestore,functions

Emulator ports (configured in firebase.json):

Next Steps

With Firebase configured, proceed to:

1. Configuration - Set up environment variables and API keys
2. Deployment - Deploy to production