Skip to main content

SuuprTests Intro

SuuprTests Intro

Welcome to the SuuprTests documentation!

What is SuuprTests?​

SuuprTests is a powerful, intuitive tool designed to revolutionize how you test your Flutter applications. Whether you are writing widget tests or full integration tests, SuuprTests provides a streamlined workflow to instrument your app, define automated interactions, and ensure your app's UI behaves exactly as expected.

Why SuuprTests?​

Writing robust UI tests in Flutter often involves navigating complex widget trees and writing repetitive boilerplate code with WidgetTester (like tester.tap(), tester.pumpAndSettle()). SuuprTests abstracts away the complexity by giving you a visually-driven, widget-focused approach to UI testing.

Key Features​

  • Widget-Focused Architecture: SuuprTests understands Flutter's rendering tree. It interacts with your UI exactly how a real user would—by tapping, scrolling, and interacting with actual widgets.
  • Robust Identification: Leverage Flutter's native Key ecosystem to reliably identify elements on the screen, ensuring your tests don't break when your UI layout changes.
  • Advanced Gestures: Beyond simple taps, SuuprTests models complex human interactions, paving the way for advanced automated flows like Drag and Drop, Pinch-to-Zoom, and more.
  • Living Documentation: By writing clear, step-by-step test definitions, your test scenarios double as living documentation for your app's use cases.

How It Works​

At its core, SuuprTests operates in a simple two-step methodology that mirrors Flutter's native testing philosophy:

  1. Find: Locate the target widget precisely on the screen using its unique identifier: (e.g., Key('login_button')).
  2. Interact: Perform exact gestures on that widget, simulating user touch events with 100% accuracy, whether is tapping, scrolling, or any common gestures a user might perform.

Ready to Dive In?​

Let's get your Flutter app instrumented and ready for robust test coverage. Proceed to the next section to learn about getting your workspace set up and writing your first test!