Flutter Web Platform Support

The UXCam Flutter SDK ships from a single plugin and supports both mobile (iOS / Android) and Flutter Web. The core analytics experience — session recording, screen tagging, events, and user properties — works on every platform. A few advanced APIs are mobile-only today; this page is the reference for which is which.

Feature Support Matrix

Legend: ✅ Supported · 🟡 Core supported · 🚧 On the roadmap · 🔬 Under exploration · ➖ Not applicable on web

How Flutter Web Sessions Differ

Flutter Web sessions are video-based rather than DOM-based, so the replay experience differs slightly from the standalone UXCam Web SDK.

Tap gestures instead of mouse movement

Mouse cursor movement is not rendered in the replay. Instead, you'll see tap gesture indicators on the video — the same way they appear in mobile session replays.

Replays may open with a brief white screen

A Flutter Web replay can start with a white screen for a moment before your app appears. This is expected: it covers the short time between UXCam starting and the first frame of your app being captured. Gestures, screens, and events are aligned with the video from the start of the session, so nothing is lost or shifted.

Iframes appear blank

Iframes are not supported on Flutter Web. Any iframe embedded in your Flutter Web app, for example through HtmlElementView, shows up as a blank area in the session replay.

This is a limitation of canvas capture. UXCam records Flutter Web sessions from the canvas that Flutter draws your app into. The browser renders an iframe as a separate HTML element outside that canvas, so its content is never part of the captured frames.

The iframe recording options of the standalone Web SDK, such as recordCrossOriginIframes, do not apply to Flutter Web.

Sensitive Data Occlusion on Web

The core occlusion API is supported on Flutter Web and covers the most common use cases — masking widgets that contain sensitive content. Advanced controls (overlay/blur modes, fine-grained per-view rules, and dashboard-driven occlusion rules) are not yet available on web. For cross-platform behavior, stick to the standard occlusion APIs.

Mobile-Only APIs

These APIs are specific to the mobile runtime and aren't part of the Flutter Web scope. Calling them on web is safe — they're no-ops and won't crash your app — but they won't produce dashboard results.

• Recording Control — programmatic start, stop, pause, and allowShortBreak of session recording
• Crash & ANR Handling — native crash capture and ANR reporting
• User Consent Management — opt-in / opt-out APIs
• Debug & Verbose Logging — native integration logging

Recommended Pattern: Guard Mobile-Only Calls

Wrap mobile-only calls in a kIsWeb check so the same codebase works across platforms:

import 'package:flutter/foundation.dart';
import 'package:flutter_uxcam/flutter_uxcam.dart';

if (!kIsWeb) {
  FlutterUxcam.optIntoVideoRecordings();
  // other mobile-only APIs...
}

Need Help?

If a feature you rely on isn't supported yet, contact [email protected] — we can advise on workarounds and share roadmap updates.