Understand the failure.
Put the fix to the test.

# pubspec.yaml: one package, every integration
dependencies:
  bug_capsule: 0.4.1-beta.7

// main.dart
import 'package:bug_capsule/bug_capsule.dart';

final bugCapsuleDio = BugCapsuleDio(rules: [
  // Fields that differ on every run must not affect request matching.
  EndpointRule('POST', '/api/checkout', ignoreBodyFields: {'timestamp', 'nonce'}),
]);
final bugCapsuleRouter = BugCapsuleGoRouter();

void main() => BugCapsule.init(            // first line of main
      config: const BugCapsuleConfig(
        appVersion: '1.4.0',
        appBuild: '52',
        mode: CaptureMode.qa,
        backend: BugCapsuleBackendConfig(url: 'https://bugcapsule.example.com', ingestKey: 'bci_...'),
      ),
      integrations: [
        BugCapsuleBloc(states: [            // or BugCapsuleRiverpod, BugCapsuleNotifiers, BugCapsuleGetx, BugCapsuleMobx
          BugCapsuleState<CartBloc, CartState>(toJson: (s) => s.toJson(), fromJson: CartState.fromJson),
        ]),
        bugCapsuleDio,                      // or BugCapsuleHttp for package:http and Chopper
        bugCapsuleRouter,
        BugCapsuleSharedPreferences(),
      ],
      appRunner: () => runApp(const MyApp()),
    );

// where you build Dio and GoRouter:
bugCapsuleDio.attach(dio);
final router = GoRouter(initialLocation: bugCapsuleRouter.initialLocation('/'), routes: [...]);
bugCapsuleRouter.attach(router);

// QA capture button:
MaterialApp.router(builder: (context, child) => BugCapsuleOverlay(child: child!), ...);

# Build with the commit pinned so replay can check out the same code
flutter build ipa --dart-define=BUGCAPSULE_GIT_SHA=$(git rev-parse HEAD) --dart-define=BUGCAPSULE_MODE=qa

// app/build.gradle.kts
android {
    defaultConfig {
        testInstrumentationRunner = "dev.bugcapsule.android.replay.BugCapsuleReplayRunner"
        // The CLI passes -PbugcapsuleGitSha=<sha> so capsules carry the build's commit.
        buildConfigField("String", "BUGCAPSULE_GIT_SHA", "\"${providers.gradleProperty("bugcapsuleGitSha").getOrElse("")}\"")
        buildConfigField("String", "BUGCAPSULE_INGEST_KEY", "\"${providers.environmentVariable("BUGCAPSULE_INGEST_KEY").getOrElse("")}\"")
    }
    buildFeatures.buildConfig = true
}
dependencies {
    implementation("io.github.bugcapsule:bugcapsule-android:0.4.1-beta.5")
    implementation("io.github.bugcapsule:bugcapsule-okhttp:0.4.1-beta.5")
    implementation("io.github.bugcapsule:bugcapsule-navigation:0.4.1-beta.5")
    implementation("io.github.bugcapsule:bugcapsule-compose:0.4.1-beta.5")        // if you use Compose
    androidTestImplementation("io.github.bugcapsule:bugcapsule-android-replay:0.4.1-beta.5")
}

// Application.onCreate, first thing
BugCapsule.init(this,
    BugCapsuleConfig.builder()
        .mode(CaptureMode.QA)
        .backend("https://bugcapsule.example.com", BuildConfig.BUGCAPSULE_INGEST_KEY)  // bci_ only
        .gitSha(BuildConfig.BUGCAPSULE_GIT_SHA)
        .build(),
    listOf(okHttp, navigation, BugCapsuleSharedPreferences.builder().allowFile("shop_prefs").build()))

// OkHttp: BugCapsule is the innermost application interceptor
OkHttpClient.Builder().addInterceptor(AuthInterceptor()).addInterceptor(okHttp.interceptor).build()

// Views and Compose: name actions, track text
BugCapsuleViews.onClick(checkoutButton, "cart.checkout") { viewModel.checkout() }
Button(onClick = rememberBugCapsuleAction("cart.checkout") { viewModel.checkout() }) { Text("Checkout") }

// Package.swift (or File → Add Package Dependencies… in Xcode)
.package(url: "https://github.com/BugCapsule/bug_capsule_ios_sdk.git", exact: "0.4.1-beta.3"),
.product(name: "BugCapsule", package: "bug_capsule_ios_sdk"),        // app target
.product(name: "BugCapsuleXCTest", package: "bug_capsule_ios_sdk"),  // UI test target

// First line of application(_:didFinishLaunchingWithOptions:) or App.init
import BugCapsule

BugCapsule.start(
    BugCapsuleConfig(
        mode: .qa,
        backend: BugCapsuleBackendConfig(url: "https://bugcapsule.example.com", ingestKey: "bci_...")),
    integrations: [
        BugCapsuleURLSession(rules: [EndpointRule("POST", "/api/checkout", ignoreBodyFields: ["nonce"])]),
        BugCapsuleUserDefaults(keys: ["cart_cache"], prefixes: ["settings."]),
        BugCapsuleNavigation.shared,
        BugCapsuleStateIntegration.shared,
    ])

// Networking: instrument the configuration your URLSession uses
let config = URLSessionConfiguration.default
BugCapsule.instrument(config)

// UIKit and SwiftUI: name actions, track text
Button("Checkout", action: BugCapsule.action("cart.checkout") { model.checkout() })
TextField("Coupon", text: BugCapsule.trackedText("cart.coupon", $model.coupon))

# Install the published beta packages
npm install @bugcapsule/web@0.4.0-beta.3 @bugcapsule/react@0.4.0-beta.3
npm install -D @bugcapsule/web-replay@0.4.0-beta.3   # only where you run bugcapsule run / verify

// main.ts: await init before rendering
import { BugCapsule, networkIntegration, historyIntegration, localStorageIntegration } from '@bugcapsule/web';

await BugCapsule.init({
  appVersion: '1.4.0',
  mode: 'qa',
  gitSha: import.meta.env.VITE_BUGCAPSULE_GIT_SHA,
  backend: { url: 'https://bugcapsule.example.com', ingestKey: 'bci_...' },
  integrations: [
    networkIntegration({ rules: [{ method: 'POST', path: '/api/checkout', ignoreBodyFields: ['nonce'] }] }),
    historyIntegration(),
    localStorageIntegration({ allowPrefixes: ['shop.'] }),
  ],
  allowReplay: import.meta.env.DEV,
});
renderApp();

// React: actions, route events, error boundary, QA capture button
<button onClick={BugCapsule.action('cart.checkout', checkout)} data-bugcapsule-action="cart.checkout">
<BugCapsuleRouteListener />  <BugCapsuleErrorBoundary>…</BugCapsuleErrorBoundary>  <BugCapsuleCaptureButton />

The CLI runs on macOS, Linux and Windows without Dart or Flutter. Install with Node.js 20+, or use a standalone binary.

npm install -g @bugcapsule/cli@0.4.0-beta.3
bugcapsule login --url https://api.bugcapsule.com --token bcp_...

bugcapsule list                                       # capsules on the backend
bugcapsule inspect <id|file|share-url>                # failure, eligibility, network, timeline
bugcapsule run <id> -d "iPhone 18 Pro" -n 3           # replay on the capsule's commit
bugcapsule run <id> --runtime android -n 3            # flutter | android | ios | web, or from bugcapsule.json
bugcapsule verify <id> -n 5                           # replay on your working tree
bugcapsule regress add <id> && bugcapsule regress run # exit 1 on failure, for CI
bugcapsule share <id>                                 # expiring public link
bugcapsule capture --on | --off | --sample-rate 0.05  # kill switch and sampling