[messaging] Enhance Expo notification icon configuration support and documentation

[Copilot]

Summary

This PR addresses issue #8616 by significantly improving the documentation and developer experience for the existing Expo notification icon configuration feature in @react-native-firebase/messaging.

The messaging package already includes an Expo config plugin (added in v18.7.0 via #7369) that automatically configures Firebase notification icons and colors from app.json, but this functionality was poorly documented and largely unknown to users.

Changes Made

📚 Enhanced Documentation

• Updated docs/messaging/usage/index.md with comprehensive Expo configuration section including:
  • Step-by-step setup instructions
  • Example app.json configuration
  • Android vs iOS behavior explanation
  • Notification icon requirements (pure white PNG)
• Updated packages/messaging/README.md with clear Expo setup instructions and example
• Added packages/messaging/EXPO_EXAMPLE.md with detailed examples and best practices

🔧 Improved Developer Experience

• Enhanced warning messages with actionable configuration examples when notification config is missing
• Added success logging when configuration is applied successfully
• Better error messaging clearly branded with [@react-native-firebase/messaging]

✅ Enhanced Testing

• Added comprehensive test coverage for various configuration scenarios
• Tests verify proper warning behavior when configuration is missing
• Tests verify successful configuration and logging messages

How It Works

The existing Expo plugin automatically:

1. Reads expo.notification.icon and expo.notification.color from app.json
2. Configures Android manifest with proper Firebase messaging metadata:
   • com.google.firebase.messaging.default_notification_icon
   • com.google.firebase.messaging.default_notification_color
3. Provides helpful warnings with examples when configuration is missing
4. Logs success messages when configuration is applied

Example Configuration

{
  "expo": {
    "notification": {
      "icon": "./assets/notification-icon.png",
      "color": "#FF0000"
    },
    "plugins": [
      "@react-native-firebase/messaging"
    ]
  }
}

Before vs After

Before: Users were unaware this feature existed and requested it as a new feature
After: Clear documentation and improved messaging make the feature discoverable and easy to use

Testing

• ✅ All existing tests pass
• ✅ New test coverage for edge cases and validation
• ✅ Linting and code quality checks pass
• ✅ Plugin builds successfully

This PR transforms an existing but hidden feature into a well-documented, user-friendly solution that fully addresses the feature request in #8616.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• docs.expo.dev
  • Triggering command: curl -s REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to my firewall allow list

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
react-native-firebase	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 17, 2025 0:54am

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[Ehesp]

(Playing around, ignore)

[github-actions]

Hello 👋, this PR has been opened for more than 2 months with no activity on it.

If you think this is a mistake please comment and ping a maintainer to get this merged ASAP! Thanks for contributing!

You have 15 days until this gets closed automatically

[mikehardy]

this is an actual issue though - was just slightly lower priority but I did want to check it out

[github-actions]

Hello 👋, this PR has been opened for more than 2 months with no activity on it.

If you think this is a mistake please comment and ping a maintainer to get this merged ASAP! Thanks for contributing!

You have 15 days until this gets closed automatically

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77.76%. Comparing base (7eaaf18) to head (38003b8).
⚠️ Report is 234 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #8618       +/-   ##
===========================================
+ Coverage   52.41%   77.76%   +25.35%     
===========================================
  Files         187      251       +64     
  Lines        7671    11367     +3696     
  Branches     1802     2753      +951     
===========================================
+ Hits         4020     8838     +4818     
+ Misses       3004     2388      -616     
+ Partials      647      141      -506     

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

Hello 👋, this PR has been opened for more than 14 days with no activity on it.

If you think this is a mistake please comment and ping a maintainer to get this merged ASAP! Thanks for contributing!

You have 7 days until this gets closed automatically