owlscope_riverpod

Riverpod adapter for OwlScope. Forwards provider lifecycle and state changes to the OwlScope desktop app.

Install

dev_dependencies:
  owlscope: ^0.1.0
  owlscope_riverpod: ^0.1.0

flutter pub get
dart run owlscope:setup

Usage

import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:owlscope/auto.dart';
import 'package:owlscope_riverpod/owlscope_riverpod.dart';

void main() {
  owlscopeAuto(() {
    runApp(
      ProviderScope(
        observers: [OwlScopeRiverpodObserver()],
        child: const MyApp(),
      ),
    );
  });
}

That's it. Every didAddProvider / didUpdateProvider / didDisposeProvider / providerDidFail is forwarded:

In the desktop UI these show up under the State panel.

Options

OwlScopeRiverpodObserver(
  emitLifecycle: false, // skip add/dispose events, only emit state changes
  maxDepth: 6,          // serialisation depth for nested objects (default 10)
)

Production

owlscope itself is a no-op in kReleaseMode, so the observer's emits never reach the network in release builds. Wrapping in if (kDebugMode) is optional but keeps the observer list literal-cleaner:

ProviderScope(
  observers: [if (kDebugMode) OwlScopeRiverpodObserver()],
  child: const MyApp(),
)