Feeddo Flutter SDK
Drop a live AI support chat into your Flutter app with just 2 lines of code.
What is Feeddo?
Feeddo is an AI-powered customer support widget for your Flutter app. Being the best Intercom alternative for Flutter, Feeddo provides a native, lightweight, and AI-first experience. Here's what it does:
- AI Agent handles simple questions by reading your docs and FAQs
- Auto-creates support tickets when the AI can't solve the issue
- Live chat - You can jump in and chat directly with users
- Smart bug tracking - Auto-detects and creates issues for bug reports
- Feature requests - Captures and organizes feature requests from users
- Community board - Let users vote on feature requests and see known bugs
All this drops right into your app with zero hassle.
Screenshots
1. Simple & Clean Home
Your users get a clean dashboard to manage their conversations and tickets.
2. AI Support Agent
If a user asks how to do something, the AI agent searches your docs and answers instantly.
3. Smart Bug Reporting
If a user reports a bug, the agent automatically gathers details and creates a bug report for you.
4. Community Board
Other users can see feature requests and reported bugs, upvote them, and add comments.
Installation
Install the latest version using:
flutter pub add feeddo_flutter
Platform Setup
iOS Setup
Feeddo requires a minimum deployment target of iOS 15.0.
- Open your project in Xcode (open
ios/Runner.xcworkspace). - Select the Runner project in the left navigation panel.
- In the project targets list, select Runner.
- Select the General tab.
- In the Deployment Info section, set Minimum Deployments to 15.0.
- Make sure your
ios/Podfilealso specifies platform 15.0:platform :ios, '15.0'
Android Setup
Feeddo requires Android minSdkVersion 21 or higher and Internet permissions:
- In
android/app/build.gradle(orbuild.gradle.kts), ensureminSdkVersionis at least 21:android { defaultConfig { minSdkVersion 21 } } - In
android/app/src/main/AndroidManifest.xml, make sure the Internet permission is present:<uses-permission android:name="android.permission.INTERNET"/>
macOS & Desktop Setup
Feeddo supports macOS, Windows, Linux, and Web out of the box.
For macOS, ensure network client entitlement is enabled in macos/Runner/DebugProfile.entitlements and Release.entitlements:
<key>com.apple.security.network.client</key>
<true/>
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):
import 'package:feeddo_flutter/feeddo_flutter.dart';
await Feeddo.init(
apiKey: 'your-api-key-here', // Get this from feeddo.dev
context: context,
);
3. Show the Support Chat
Add a button anywhere in your app to open the support widget:
ElevatedButton(
onPressed: () {
Feeddo.show(context); // Opens the support home screen
},
child: Text('Get Help'),
)
That's it! Your users can now chat with the AI and create support tickets.
4. Show the Community Board
Want to show just the feature requests and bug reports? Use this:
ElevatedButton(
onPressed: () {
Feeddo.showCommunityBoard(context); // Opens feature requests & bugs
},
child: Text('Request a feature'),
)
Understanding Feeddo.init()
The init() method sets up Feeddo with your user data. Here's what each parameter does:
await Feeddo.init(
// Required: Your API key from feeddo.dev
apiKey: 'your-api-key',
// Required: The BuildContext for showing notifications
context: context,
// Optional: Your app's user ID (links Feeddo to your users)
externalUserId: 'user_12345',
// Optional: User's display name (appears in chats)
userName: 'John Doe',
// Optional: User's email
email: 'john@example.com',
// Optional: Segment your users (e.g., 'pro', 'free', 'trial')
userSegment: 'premium',
// Optional: Track subscription status
subscriptionStatus: 'active',
// Optional: Any extra data you want to track
customAttributes: {
'plan': 'pro',
'signupDate': '2026-01-01',
'country': 'US',
},
// Optional: Enable/disable in-app notifications (default: true)
isInAppNotificationOn: true,
// Optional: Push notification token (for remote notifications)
pushToken: 'fcm-token-here',
// Optional: Push provider (fcm, apns, or onesignal)
pushProvider: FeeddoPushProvider.fcm,
);
Returns: The userId that Feeddo created for this user.
Notifications Setup
Push notifications are essential for Feeddo to work effectively—ensuring users receive live developer replies, task status updates, comments, and release announcements even when your app is backgrounded or closed.
Option A: iOS-Only Apps (Direct APNs via feeddo_push_notification_apns)
If your app targets iOS only, use the official feeddo_push_notification_apns companion package. It communicates directly with Apple APNs without Firebase and requires zero Swift code in AppDelegate.swift:
- Install companion package:
flutter pub add feeddo_push_notification_apns - Xcode Setup: Enable Push Notifications in Signing & Capabilities, and add
NSUserNotificationsUsageDescriptiontoios/Runner/Info.plist. - Initialize in
main():import 'package:feeddo_push_notification_apns/feeddo_push_notification_apns.dart'; void main() async { WidgetsFlutterBinding.ensureInitialized(); await FeeddoPushNotificationApns.instance.initialize(); runApp(const MyApp()); } - Wire to Feeddo SDK:
await Feeddo.init( apiKey: '<YOUR_FEEDDO_API_KEY>', context: context, pushToken: FeeddoPushNotificationApns.instance.token, pushProvider: FeeddoPushProvider.apns, isInAppNotificationOn: true, ); // Auto-sync token updates, handle notification taps, and display in-app banner in foreground: FeeddoPushNotificationApns.instance.attachToFeeddo( onToken: (token) => Feeddo.registerPushToken( pushToken: token, pushProvider: FeeddoPushProvider.apns, ), onNotificationTap: (payload) => Feeddo.handleNotificationTap(context, payload), onForegroundNotification: (payload) => Feeddo.handleForegroundNotification( payload, context: context, ), ); - Request permission contextually (in Settings or Onboarding):
await FeeddoPushNotificationApns.instance.requestNotificationPermissions(); - Feeddo Server Setup: In feeddo.dev → Settings → Notifications → Apple (APNs), enter your Team ID, Key ID, Bundle ID (Topic), Environment (Sandbox vs Production), and upload your
AuthKey_<KEY_ID>.p8key.
Option B: Cross-Platform Apps (Firebase / FCM)
1. Configure App & Feeddo Server
- In Firebase Console > Project Settings > Service accounts, generate a private key (JSON).
- In feeddo.dev → Settings > Notifications > Google (FCM), upload the JSON file.
- Under For End Users, confirm notification triggers are enabled.
2. Register Your Token & Handlers
String? token = await FirebaseMessaging.instance.getToken();
await Feeddo.init(
apiKey: '<YOUR_FEEDDO_API_KEY>',
context: context,
pushToken: token,
pushProvider: FeeddoPushProvider.fcm,
);
// Token refresh
FirebaseMessaging.instance.onTokenRefresh.listen((newToken) {
Feeddo.registerPushToken(
pushToken: newToken,
pushProvider: FeeddoPushProvider.fcm,
);
});
// Terminated launch tap
final initialMessage = await FirebaseMessaging.instance.getInitialMessage();
if (initialMessage != null && context.mounted) {
await Feeddo.handleNotificationTap(context, initialMessage.data);
}
// Background notification tap
FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
if (context.mounted) {
Feeddo.handleNotificationTap(context, message.data);
}
});
// Suppress native system notification in foreground
await FirebaseMessaging.instance.setForegroundNotificationPresentationOptions(
alert: false,
badge: true,
sound: false,
);
// Show Feeddo in-app banner for foreground notifications
FirebaseMessaging.onMessage.listen((RemoteMessage message) {
if (context.mounted) {
Feeddo.handleForegroundNotification(
message.data,
context: context,
title: message.notification?.title,
message: message.notification?.body,
);
}
});
Customizing Colors
Feeddo comes with dark and light themes, but you can customize any color:
Using Built-in Themes
// Dark theme (default)
Feeddo.show(context, theme: FeeddoTheme.dark());
// Light theme
Feeddo.show(context, theme: FeeddoTheme.light());
Custom Colors
Create your own theme by customizing colors:
final myTheme = FeeddoTheme(
isDark: true,
colors: FeeddoColors(
// Main background
background: Color(0xFF1A1A2E),
// Text colors
textPrimary: Color(0xFFFFFFFF),
textSecondary: Color(0xFFB0B0B0),
// Primary action color (buttons, links)
primary: Color(0xFF00D9FF),
// Cards and surfaces
cardBackground: Color(0xFF252540),
surface: Color(0xFF252540),
// App bar
appBarBackground: Color(0xFF1A1A2E),
// Status colors
success: Color(0xFF4CAF50),
error: Color(0xFFFF5252),
// Borders and dividers
border: Color(0xFF3A3A5C),
divider: Color(0xFF2A2A3E),
),
);
// Use it when showing Feeddo
Feeddo.show(context, theme: myTheme);
You can also apply the theme to notifications and the community board:
// Show with custom theme
Feeddo.show(context, theme: myTheme);
Feeddo.showCommunityBoard(context, theme: myTheme);
// Set default theme in init()
await Feeddo.init(
apiKey: 'your-api-key',
context: context,
theme: myTheme, // This theme will be used for notifications
);
Available Colors
| Color Property | What it controls |
|---|---|
background |
Main screen background |
textPrimary |
Primary text (titles, main content) |
textSecondary |
Secondary text (timestamps, hints) |
cardBackground |
Background of cards and message bubbles |
primary |
Primary buttons, links, active elements |
surface |
Secondary surfaces (bottom sheets) |
success |
Success states, completed tasks |
error |
Error states, urgent notifications |
border |
Borders around inputs and cards |
divider |
Separators between items |
appBarBackground |
Top navigation bar background |
Gradient Background
Want a gradient background? Easy:
final gradientTheme = FeeddoTheme(
isDark: true,
colors: FeeddoColors(
background: Color(0xFF1A1A2E), // Fallback color
backgroundGradient: [
Color(0xFF1A1A2E),
Color(0xFF16213E),
Color(0xFF0F3460),
],
),
);
Update User Info
Need to update user info after they sign up or change their profile?
await Feeddo.updateUser(
userName: 'Jane Smith',
email: 'jane@example.com',
userSegment: 'enterprise',
);
Show Unread Message Count
Want to show a badge with unread messages?
int unreadCount = Feeddo.unreadMessageCount;
// Use it in your UI
Badge(
label: Text('$unreadCount'),
child: Icon(Icons.chat),
)
Desktop & Web Floating Widget
On Desktop (macOS, Windows, Linux) and Web, Feeddo automatically opens as a sleek Intercom-style floating window in the bottom-right corner rather than a full-screen view.
You can customize the desktop popup window constraints:
Feeddo.show(
context,
useSmallWindowOnDesktop: true, // Default: true (set to false for fullscreen dialog)
desktopConstraints: const BoxConstraints(
maxWidth: 420,
maxHeight: 650,
),
);
User Logout & Cleanup
When a user logs out of your app, call Feeddo.dispose() to reset SDK state, disconnect WebSockets, and clear active notifications:
Feeddo.dispose();
Need Help?
- Docs: docs.feeddo.dev
- Website: feeddo.dev
- Issues: GitHub Issues
License
MIT License - see LICENSE file for details