Skip to main content

fullstory_flutter 1.76.2 copy "fullstory_flutter: ^1.76.2" to clipboard
fullstory_flutter: ^1.76.2 copied to clipboard

Visual capture support for Fullstory session replay

fullstory_flutter #

fullstory_flutter provides Fullstory autocapture capabilities to support session replay by integrating with the existing Fullstory Native Mobile SDKs.

This plug-in is intended to be used in conjunction with Fullstory for Mobile Apps.

Setting up Flutter session replay #

Follow the steps from this article to configure session replay.

iOS setup #

Swift Package Manager (default) #

Swift Package Manager is on by default from Flutter 3.44, and it installs the Fullstory iOS SDK for you. Add this to your app's Release build settings, either in Xcode or in ios/Flutter/Release.xcconfig:

STRIP_STYLE = non-global

Without it, a Release archive strips the symbols this plugin looks up, and Fullstory fails at startup with Failed to lookup symbol ... symbol not found. Debug builds don't need it.

CocoaPods #

CocoaPods trunk is read-only from December 2, 2026, and no longer accepts new Fullstory versions. If you turn Swift Package Manager off, add the Fullstory pod to ios/Podfile with the same version this plugin uses:

pod 'FullStory', :http => 'https://ios-releases.fullstory.com/fullstory-X.Y.Z-xcframework.tar.gz'

Then run pod update FullStory from the ios directory. The pod name is case-sensitive.

pod install fails if the Podfile has no FullStory line, or one without a URL, since that pod would come from trunk. To build anyway, set FS_ALLOW_TRUNK=1.

Add-to-app #

Flutter doesn't support Swift Package Manager for add-to-app modules yet, so module builds always use CocoaPods. Don't add the Fullstory pod to the module's .ios/Podfile, since flutter clean regenerates that file. Instead:

  • If your app embeds the module through its own Podfile (install_all_flutter_pods), add the Fullstory pod there.
  • If you build frameworks (flutter build ios-framework or flutter build swift-package), copy the module's .ios folder to ios, check it in, and add the Fullstory pod to ios/Podfile. Flutter uses ios instead of .ios when it exists.

Unmasking text and images #

Mobile sessions on Fullstory are Private by Default, so all text and images will be masked in initial sessions. To unmask parts of your app with, follow these steps.

Optional additional setup #

If you wish to enable additional data capture, such as pages, crashes, and network requests, please follow the steps in our developer documentation.

Custom classes and attributes #

Use FSCustomAttributes to add custom classes or attributes to your widgets. Wrap the widget you want to annotate with FSCustomAttributes and add any classes or attributes you wish to include.

Example usage #

FSCustomAttributes {
  classes: ['class1', 'class2'],
  attributes: {'field1': 'value1'},
  child: YourAnnotatedWidget(),
}