Push Notifications Setup Guide

This guide will help you set up push notifications for your MartFury Flutter app. Follow these simple steps to enable notifications for both Android and iOS.

📱 What You'll Need

Before starting, make sure you have:

• A Google account (for Firebase)
• Access to your app's source code
• For iOS: An Apple Developer account ($99/year)

🔥 Step 1: Create a Firebase Project

1. Go to Firebase Console
2. Click "Create a project" or "Add project"
3. Enter your project name (e.g., "MartFury App")
4. Follow the setup wizard (you can disable Google Analytics if not needed)
5. Click "Create project" and wait for it to complete

🤖 Step 2: Get Android Configuration File

Follow these steps to get your google-services.json file:

1. In Firebase Console:

   • Click the Android icon or "Add app" → "Android"
   • Enter your Android package name (e.g., com.yourcompany.martfury)
   • Register the app

2. Download the configuration file:

   • Click "Download google-services.json"
   • Save this file to your computer

3. Add the file to your app:

   • Open your app's folder
   • Navigate to android/app/
   • Copy the google-services.json file here

For detailed instructions with screenshots, visit: Firebase Android Setup Guide

🍎 Step 3: Get iOS Configuration File

Follow these steps to get your GoogleService-Info.plist file:

1. In Firebase Console:

   • Click "Add app" → "iOS"
   • Enter your iOS bundle ID (e.g., com.yourcompany.martfury)
   • Register the app

2. Download the configuration file:

   • Click "Download GoogleService-Info.plist"
   • Save this file to your computer

3. Add the file to your app:

   • Open your app's folder
   • Navigate to ios/Runner/
   • Copy the GoogleService-Info.plist file here

4. Enable Push Notifications in Xcode:

   • Open ios/Runner.xcworkspace in Xcode
   • Select your project in the left sidebar
   • Click on the "Signing & Capabilities" tab
   • Click "+ Capability"
   • Add "Push Notifications"

For detailed instructions with screenshots, visit: Firebase iOS Setup Guide

✅ Step 4: Configure iOS Push Notifications (iOS Only)

For iOS to receive push notifications, you need to set up APNs certificates:

1. In Firebase Console:

   • Go to Project Settings (gear icon)
   • Click "Cloud Messaging" tab
   • Scroll to "Apple app configuration"

2. Upload APNs Certificate:

   • Click "Upload" under APNs certificates
   • You'll need to create this certificate in your Apple Developer account
   • Follow Firebase's guide for creating APNs certificates

🧪 Step 5: Test Your Setup

After adding both configuration files:

1. Build and run your app:

   • Connect a real device (not simulator)
   • Run the app

2. Test notifications:

   • Go to Firebase Console
   • Navigate to "Cloud Messaging"
   • Click "Send your first message"
   • Enter a test message and send

3. Check if it works:

   • You should receive the notification on your device
   • If not, check the Troubleshooting section below

❓ Troubleshooting

Nothing happens when I send a test notification

• Make sure you're using a real device (not simulator/emulator)
• Check that you copied the files to the correct folders
• For iOS: Ensure you enabled Push Notifications in Xcode
• Try restarting the app

Where do I find my package name/bundle ID?

• Android package name: Look in android/app/build.gradle for applicationId
• iOS bundle ID: Look in Xcode under your target's General tab

I don't have an Apple Developer account

• You need one for iOS push notifications in production ($99/year)
• For testing only, you might be able to use development certificates

📞 Need More Help?

If you're stuck:

1. Double-check you followed all steps above
2. Make sure file names are exactly google-services.json and GoogleService-Info.plist
3. Verify files are in the correct folders
4. Contact your developer for assistance with technical issues