Flutter SDK - One-page setup

Prerequisites

• Create a TesterNest account and log in.
• Create an app in the TesterNest dashboard.
• Copy your publicKey from the app settings.
• If your organization uses a custom baseUrl, note it now.

Install dependency

Add the SDK to your pubspec.yaml:

dependencies:
  testernest_flutter: ^1.0.0

Then run:

flutter pub get

Initialize the SDK

Initialize once during app startup, typically in main() before runApp():

void main() {
  TesterNest.initialize(
    publicKey: 'YOUR_PUBLIC_KEY',
    baseUrl: 'https://api.testernest.com', // optional
  );

  runApp(const MyApp());
}

Show the connect prompt

Add the connect prompt widget on your main screen so testers can enter a 6-digit code:

class HomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Stack(
        children: [
          const AppContent(),
          TesterNestConnectPrompt(),
        ],
      ),
    );
  }
}

When a tester opens the app, they should see a 6-digit code entry prompt.

Verify

• In the app, the prompt displays and accepts a 6-digit code.
• In your logs, you should see bootstrap and claim events after entering a code.
• The TesterNest dashboard should show an active session.

Troubleshooting

• No prompt appears: Ensure TesterNestConnectPrompt is mounted and visible on top of your UI.
• Invalid key: Confirm the publicKey matches the app in the dashboard.
• Network errors: Verify device internet access and any required baseUrl value.
• Nothing in logs: Make sure initialization runs before the prompt renders.