Flutter Integration

Copy as Markdown

Feeddo allows you to drop a live AI support chat into your Flutter app with just 2 lines of code.

Installation

Add feeddo_flutter to your pubspec.yaml:

dependencies:
  feeddo_flutter: ^0.1.2

Then install the package:

flutter pub get

iOS Setup

Feeddo requires a minimum deployment target of iOS 15.0.

1. Open your project in Xcode (open ios/Runner.xcworkspace).

2. Select the Runner project in the left navigation panel.

3. In the project targets list, select Runner.

4. Select the General tab.

5. In the Deployment Info section, set Minimum Deployments to 15.0.

6. Ensure your ios/Podfile also specifies platform 15.0:

   platform :ios, '15.0'

Quick Start

1. Get Your API Key

Sign up at feeddo.dev and grab your API key from the dashboard.

2. Initialize Feeddo

Call Feeddo.init() when your app starts (usually in your main screen or main.dart).

import 'package:feeddo_flutter/feeddo_flutter.dart';

// ... inside your widget or initialization logic
await Feeddo.init(
  apiKey: 'your-api-key-here',
  context: context,
);

3. Show the Support Chat

Add a button anywhere in your app to open the support widget:

ElevatedButton(
  onPressed: () {
    Feeddo.show(context);
  },
  child: Text('Get Help'),
)

4. Show the Community Board

To show feature requests and bug reports directly:

ElevatedButton(
  onPressed: () {
    Feeddo.showCommunityBoard(context);
  },
  child: Text('Request a feature'),
)

Configuration

The init() method supports various parameters to customize the user experience.

await Feeddo.init(
  apiKey: 'your-api-key',
  context: context,

  // User identification
  externalUserId: 'user_12345',
  userName: 'John Doe',
  email: '[email protected]',

  // Segmentation
  userSegment: 'premium',
  subscriptionStatus: 'active',

  // Custom data
  customAttributes: {
    'plan': 'pro',
    'country': 'US',
  },

  // Notifications
  isInAppNotificationOn: true,
  pushToken: 'fcm-token-here',
  pushProvider: FeeddoPushProvider.fcm,
);

Notifications

Push Notifications Setup

1. Configure App & Dashboard

To allow Feeddo to send push notifications, you need to provide your Firebase Service Account credentials:

1. Go to the Firebase Console > Project Settings > Service accounts.
2. Click Generate new private key to download the JSON file.
3. Go to feeddo.dev, select your app, and navigate to Settings > Notifications.
4. Select Google (FCM) and upload the JSON file (or paste its contents).

If you haven’t set up push notifications in your Flutter app yet, follow the Firebase Cloud Messaging Get Started guide.

2. Register Your Token

To get notifications even when the app is closed, register your push token:

String? token = await FirebaseMessaging.instance.getToken();
// When you get the FCM token
await Feeddo.registerPushToken(
  pushToken: token,
  pushProvider: FeeddoPushProvider.fcm,  // or .apns, .onesignal
);

Or pass it directly to init():

await Feeddo.init(
  apiKey: 'your-api-key',
  context: context,
  pushToken: 'your-push-token',
  pushProvider: FeeddoPushProvider.fcm,
);

Handle incoming messages:

// Background/Terminated
FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
  Feeddo.handleNotificationTap(context, message.data);
});

// Foreground
FirebaseMessaging.onMessage.listen((RemoteMessage message) {
  Feeddo.showInappNotification(
    context: context,
    title: message.notification?.title ?? 'New Message',
    message: message.notification?.body ?? '',
    data: message.data,
  );
});

Customization

You can customize the look and feel using FeeddoTheme.

Basic Themes

// Dark theme
Feeddo.show(context, theme: FeeddoTheme.dark());

// Light theme
Feeddo.show(context, theme: FeeddoTheme.light());

Custom Colors

final myTheme = FeeddoTheme(
  isDark: true,
  colors: FeeddoColors(
    background: Color(0xFF1A1A2E),
    textPrimary: Color(0xFFFFFFFF),
    primary: Color(0xFF00D9FF),
    // ... customized colors
  ),
);

Feeddo.show(context, theme: myTheme);

Others

Unread Message Count

int unreadCount = Feeddo.unreadMessageCount;

Update User Info

await Feeddo.updateUser(
  userName: 'Jane Smith',
  email: '[email protected]',
);