firebase-in-app-messaging — Claude Code skill: how to install
Guides Firebase In-App Messaging setup in Flutter: trigger and suppress popups during sensitive flows, configure GDPR opt-in collection, and run tests via test device IDs.
MIT ★ 674 updated 2026-10-29
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rulesWhat firebase-in-app-messaging does
This skill directs the agent on implementing firebase_in_app_messaging in Flutter projects. It covers initial setup after Firebase.initializeApp(), programmatic triggers using triggerEvent, and temporary message suppression with setMessagesSuppressed. Suppressing popups during payments or onboarding prevents unwanted interruptions. Suppression turns off on app restarts, and missed events are dropped rather than queued.
The skill also details privacy workflows for GDPR compliance. It explains how to turn off automatic data collection in Info.plist and AndroidManifest.xml, activating it via setAutomaticDataCollectionEnabled only after explicit opt-in. Runtime preferences persist across restarts and override XML values.
For testing, the instructions detail locating the Installation ID in Android logcat or Xcode logs using -FIRDebugEnabled. Relying on normal delivery makes debugging slow: the SDK checks the server only once per day.
What it helps with
- integrate Firebase In-App Messaging into a Flutter codebase
- suppress disruptive popups during checkout and onboarding flows
- enforce GDPR compliance through opt-in data collection switches
- preview test campaigns on physical hardware using an Installation ID
Example prompts for the agent
- Suppress Firebase in-app messages on our payment screen widget
- Configure opt-in data collection in AndroidManifest.xml and Info.plist for GDPR
- Show how to find the Installation ID in logcat to test an in-app campaign
How to install firebase-in-app-messaging
1Plugin marketplace
/plugin marketplace add evanca/flutter-ai-rules/plugin install flutter-ai-skills@flutter-ai-rulesThis installs the whole flutter-ai-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill firebase-in-app-messaging -a claude-code3Manually: put the files in place
~/.claude/skills/firebase-in-app-messaging/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/firebase-in-app-messaging/
1Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill firebase-in-app-messaging -a codex2Manually: put the files in place
.agents/skills/firebase-in-app-messaging/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill firebase-in-app-messaging -a cursor2Manually: put the files in place
.cursor/skills/firebase-in-app-messaging/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install evanca/flutter-ai-rules skills/firebase-in-app-messaging2Manually: put the files in place
.github/skills/firebase-in-app-messaging/SKILL.md1Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill firebase-in-app-messaging -a gemini-cli2Platform CLI
gemini skills install https://github.com/evanca/flutter-ai-rules --path skills/firebase-in-app-messagingManually: put the files in place
.devin/skills/firebase-in-app-messaging/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about firebase-in-app-messaging
How do I install firebase-in-app-messaging in Claude Code?
Register the repository by running /plugin marketplace add evanca/flutter-ai-rules, then run /plugin install flutter-ai-skills@flutter-ai-rules. Alternatively, install the single skill with npx skills add evanca/flutter-ai-rules --skill firebase-in-app-messaging -a claude-code.
What does firebase-in-app-messaging do?
It guides coding agents on using firebase_in_app_messaging in Flutter apps. The guide includes code snippets for custom event triggers, message suppression during sensitive flows, GDPR consent toggles, and device-level testing.
How do I test a campaign before public rollout?
Locate the Installation ID via Android logcat (FIAM.Headless) or the Xcode debug console using the -FIRDebugEnabled argument. Enter this ID into the "Test on your Device" modal within the Firebase console.
Source text
SKILL.md · MIT
---
name: firebase-in-app-messaging
description: "Use when running in-app message campaigns, triggering/suppressing messages, configuring opt-in data collection, testing on specific devices, or handling message callbacks."
license: MIT
---
# Firebase In-App Messaging Skill
This skill defines how to correctly implement Firebase In-App Messaging in Flutter applications, covering setup, programmatic triggers, privacy controls, testing workflows, and campaign management.
## When to Use
Use this skill when:
* Setting up Firebase In-App Messaging in a Flutter project.
* Triggering or suppressing in-app messages programmatically.
* Implementing opt-in data collection for GDPR or user privacy compliance.
* Testing campaigns with specific devices before rollout.
* Configuring message types, targeting rules, and A/B tests.
---
## 1. Setup and Configuration
```
flutter pub add firebase_in_app_messaging
```
```dart
import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
```
- Initialize Firebase before using any In-App Messaging features.
- In-App Messaging **retrieves messages from the server once per day** by default to conserve power.
### Setup Checklist
1. Confirm `Firebase.initializeApp()` completes before accessing In-App Messaging.
2. Create a test campaign in the Firebase console to verify the integration.
3. Locate the Installation ID for device-specific testing (see Testing section).
---
## 2. Message Triggering and Display
Use Google Analytics events to trigger in-app messages without additional code. For programmatic triggering:
```dart
// Trigger a message tied to a custom event
await FirebaseInAppMessaging.instance.triggerEvent("purchase_complete");
```
### Suppress Messages During Critical Flows
```dart
class PaymentScreen extends StatefulWidget {
@override
State<PaymentScreen> createState() => _PaymentScreenState();
}
class _PaymentScreenState extends State<PaymentScreen> {
@override
void initState() {
super.initState();
// Suppress messages during payment
FirebaseInAppMessaging.instance.setMessagesSuppressed(true);
}
@override
void dispose() {
// Re-enable messages when leaving payment flow
FirebaseInAppMessaging.instance.setMessagesSuppressed(false);
super.dispose();
}
}
```
- Suppression is **automatically turned off** on app restart.
- Suppressed messages are ignored — their trigger conditions must be met again after suppression is lifted.
- Common flows to suppress: payment processing, onboarding wizards, form submission screens.
---
## 3. User Privacy and Opt-In Data Collection
By default, In-App Messaging automatically delivers messages to all targeted users.
**Disable automatic collection — iOS** (`Info.plist`):
```xml
<key>FirebaseInAppMessagingAutomaticDataCollectionEnabled</key>
<false/>
```
**Disable automatic collection — Android** (`AndroidManifest.xml`):
```xml
<meta-data
android:name="firebase_inapp_messaging_auto_data_collection_enabled"
android:value="false" />
```
**Enable for users who opt in at runtime:**
```dart
// Call after user consents to data collection
Future<void> enableMessaging() async {
await FirebaseInAppMessaging.instance.setAutomaticDataCollectionEnabled(true);
}
// Call if user revokes consent
Future<void> disableMessaging() async {
await FirebaseInAppMessaging.instance.setAutomaticDataCollectionEnabled(false);
}
```
- Manually set preferences **persist through app restarts**, overriding configuration file values.
- For GDPR compliance, disable automatic collection by default and enable only after explicit user consent.
---
## 4. Testing and Debugging
### Find the Installation ID
- **Android:** Filter logcat by `FIAM.Headless` — look for `Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID`.
- **iOS:** Add `-FIRDebugEnabled` as a runtime argument in Xcode scheme settings. Look for `[Firebase/InAppMessaging][I-IAM180017]` in the console.
### Test a Campaign
1. In the Firebase console, open the campaign and select **Test on your Device**.
2. Enter the Installation ID from the step above.
3. The test message appears on the next app launch or foreground event.
- Always test on **actual devices** for proper rendering and behavior.
- Test each message type (modal, banner, card, image-only) to verify layout on different screen sizes.
---
## 5. Campaign Management
- Create campaigns in the Firebase console under **Messaging > In-App Messaging**.
- Message types: **modal**, **banner**, **card**, or **image-only**.
### Campaign Configuration Workflow
1. **Design** — Select the message type and customize appearance (title, body, image, button).
2. **Target** — Define the audience by app version, language, user segment, or Analytics-based conditions.
3. **Schedule** — Set start/end dates and frequency caps (once, once per session, etc.).
4. **Trigger** — Choose the Analytics event that displays the message (e.g., `app_open`, `purchase_complete`).
5. **Test** — Use device testing before publishing.
6. **Publish** — Launch the campaign and monitor performance.
- Use **custom metadata** (key-value pairs) to pass additional info accessible when users interact with messages.
- Use **A/B testing** to optimize message content, timing, and conversion rates.
- Monitor campaign performance (impressions, clicks, conversions) through Firebase console analytics.
---
## References
- [Firebase In-App Messaging Flutter documentation](https://firebase.google.com/docs/in-app-messaging/get-started?platform=flutter)
© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules