Why add feedback to Flutter apps?
The whole integration is one HTTP call; everything else is a widget (the Flutter kind) you already know how to build.
Step 1: Create a TellTide app and copy your App ID and API key
Sign in to TellTide, open Apps, and create an app with the Mobile App or Desktop App platform label. Copy the App ID and the API key shown at creation. Native apps authenticate with the API key (an x-api-key header) instead of the website origin check, so store the key securely — an environment variable, secure storage, or your backend.
Step 2: Post feedback with the http package
Send the submission as JSON with your API key in the header:
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> sendFeedback(String type, String comment) async {
await http.post(
Uri.parse('https://telltide.com/api/feedback'),
headers: {
'Content-Type': 'application/json',
'x-api-key': telltideApiKey,
},
body: jsonEncode({
'appId': telltideAppId,
'type': type, // 'feedback' | 'review' | 'bug' | 'feature'
'comment': comment,
'page_url': 'myapp://settings',
'page_title': 'Settings',
}),
);
}Step 3: Verify the submission in your inbox
Send a test request and check the response for a feedbackId. The submission appears in your TellTide inbox immediately, tagged with the page_url and page_title context you sent — use those fields for the screen name, route, or deep link the user was on.
Good to know
- Store the key with --dart-define or your secrets tooling rather than hard-coding it.
- Reviews accept a rating field (1–5); bug reports can carry structured detail in feedback_data.
- One TellTide app can serve iOS and Android builds together, or split them for per-platform triage.
Common questions
Should iOS and Android share one TellTide app?
Share one if you triage mobile feedback as a single stream; create two if platform-specific bugs dominate. Either way the API request is identical — only the App ID changes.
Is there a native TellTide SDK for Flutter?
No SDK is required — the API is one JSON POST with two IDs, small enough that a wrapper library would be more code than the integration itself. Your HTTP client of choice already does the job.
Is the feedback public?
No. Every submission lands in your private TellTide inbox first. You choose which feature requests to publish to your public roadmap, where users can vote and comment.
How much does TellTide cost?
The free plan includes the widget, private inbox, API, and public roadmap for one app. Paid plans add unlimited apps and advanced features — pricing never scales with how many users you have.