uicheck_flutter

Source: README

Install

flutter pub add uicheck_flutter

Flutter runtime client for UI Check. It connects a running Flutter app to @uicheck/mcp over WebSocket so AI agents can request screenshots and inspect the live Flutter render tree.

Usage

Add the package:

flutter pub add uicheck_flutter

Start the MCP server separately:

npx @uicheck/mcp

Install the Flutter client near app startup:

import 'package:flutter/widgets.dart';
import 'package:uicheck_flutter/uicheck_flutter.dart';
 
final uicheckClient = initUiCheck(
  UiCheckFlutterOptions(
    socket: UiCheckSocketOptions(
      clientId: 'flutter-demo',
    ),
    screenshot: (params) => captureRepaintBoundaryAsPng(
      repaintBoundaryKey: appBoundaryKey,
    ),
  ),
);

Wrap the app or screen in a RepaintBoundary when using the screenshot helper:

final appBoundaryKey = GlobalKey();
 
RepaintBoundary(
  key: appBoundaryKey,
  child: MyApp(),
);

Dispose the client when it is no longer needed:

uicheckClient.dispose();

Options

OptionTypeDefaultDescription
socket.urlString-@uicheck/mcp WebSocket URL
socket.clientIdString-Optional stable client id
socket.reconnectMsint1000Reconnect interval
screenshotUiCheckScreenshotProvider-Optional screenshot function for capture_page, capture_element, and compare_screenshot, returning PNG base64