riverpod_devtools

pub package

A DevTools extension for Riverpod - inspect and monitor your providers in real-time.

Riverpod DevTools Demo

Features

  • Provider Graph: Visualize the relationships between your providers (Beta: Learning-based tracking).
  • State Inspector: View the current state of your providers with type labels and optimized display.
  • Event Log: Track provider lifecycle events with hierarchical grouping and sub-events.
  • Light Mode Support: Seamlessly switch between light and dark themes.

Getting started

  1. Add riverpod_devtools to your pubspec.yaml:

    Run the command:

    flutter pub add riverpod_devtools
    

    Or manually add it:

    dependencies:
      riverpod_devtools: ^0.4.4
      flutter_riverpod: '>=2.3.0 <4.0.0'
    

    Note: This package supports both Riverpod 2.x and 3.x.

  2. Add RiverpodDevToolsObserver to your ProviderScope:

    While the DevTools extension is automatically detected, you must add the observer to enable communication between your app and the DevTools.

    import 'package:flutter_riverpod/flutter_riverpod.dart';
    import 'package:riverpod_devtools/riverpod_devtools.dart';
    
    void main() {
      runApp(
        ProviderScope(
          observers: [
            RiverpodDevToolsObserver(),
          ],
          child: MyApp(),
        ),
      );
    }
    

Usage

  1. Run your Flutter app.
  2. Open semantic DevTools (open the debugger).
  3. Look for the "riverpod_devtools" tab in DevTools.
  4. Interact with your app and watch the events and state updates in the DevTools tab.

Additional information

Contributions are welcome!

License

This package is released under the MIT License. See LICENSE for details.

Libraries

riverpod_devtools