flutteradgents 0.3.2

Flutteradgents is a tool for testers and QA teams that, directly within the project, lets them log into Jira, capture and annotate screenshots, and quickly create and assign bug tickets with all the n [...]

flutteradgents

[Flutteradgents logo]

flutteradgents helps testers and QA validate mobile and web apps from inside the host application. Users can sign in, capture feedback (annotated screenshots or an experimental GIF recording), and submit issues to your Flutteradgents backend. When Jira is configured for the project, tickets can be created or synced with assignee support.

Each issue can include structured metadata, for example:

• Environment (flavor / environment field)
• Platform (web, iOS, Android, desktop)
• Device and OS (where available)
• Build number and app version
• App name

Requirements

• Dart SDK: ^3.9.0 (see pubspec.yaml)

Installation

In your app pubspec.yaml:

dependencies:
  flutteradgents: ^0.3.0 # or path: ../flutteradgents

Then:

flutter pub get

Quick start

Wrap your app with FlutteradgentsHosts and pass FlutteradgentsSettings.simple (project id and optional flavor). Use Flutteradgents.materialAppBuilder on MaterialApp.builder so the secret tap menu works globally.

return FlutteradgentsHosts(
  settings: FlutteradgentsSettings.simple(
    projectId: 'fad_XXXXXXXX', // from the dashboard (SDK key or project UUID)
    flavor: 'develop', // sent as API `environment` unless overridden
  ),
  child: MaterialApp(
    builder: Flutteradgents.materialAppBuilder,
    home: const MyHomePage(),
  ),
);

Opening the flow (secret tap)

By default, Flutteradgents.materialAppBuilder listens for a secret tap: the user taps 5 times quickly anywhere on the content. That opens the Flutteradgents menu:

• Screenshot: annotate and send a PNG (optional crop after capture when enabled on the theme).
• GIF recording (experimental): record the UI via widget_recorder_flutter, encode to GIF, then open the ticket form.

If the user is not signed in, the sign-in UI is shown first.

You can change the tap count (and optional invite token for OAuth):

builder: (context, child) => Flutteradgents.materialAppBuilder(
  context,
  child,
  secretTapCount: 5,
  inviteToken: null,
),

Opening feedback from code

You can also start the same flow programmatically:

await Flutteradgents.showFeedback(context);

Sign-in

The API uses JWT authentication. The package supports:

• Email and password (/api/v1/auth/login)
• Atlassian OAuth (optional), with returnUri / deep link configuration aligned with your server and native manifests (AndroidManifest / Info.plist). On mobile, use the same custom scheme as in your app; FlutteradgentsSettings.simple sets a sensible default OAuth return URI off-platform.

UI language

Built-in feedback strings (Navigate, Draw, Submit, etc.) are English by default. The library still includes optional delegates such as FrAdgentsReportStrings in translation.dart; to use them you must host AdgentsReportScope yourself and pass localeOverride (for example Locale('fr')). FlutteradgentsHosts always uses the English default for that scope.

API error message text follows your server configuration and may not be English.

Example app

A runnable example ships in example/:

cd example
flutter pub get
flutter run

Repository

Source and issue tracker: see repository / issue_tracker in pubspec.yaml.