Skip to content
cccskills
FreePublished on GitHub

riverpod-ref-read-in-dispose

Fix Riverpod "Using ref when widget is unmounted is unsafe" error in ConsumerStatefulWidget. Use when: (1) Error thrown in dispose() when calling ref.read(), (2) Need to call a service method during widget cleanup, (3) ConsumerStatefulWidget needs to perform actions on provider when user navigates away. Solution: cache the service/notifier in initState with late final.

The English summary is being prepared. Showing the original description.

divinevideo/divine-mobile
See how to install

Files included (1)

  • SKILL.md3.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Riverpod ref.read() in dispose() Error

Problem

When a ConsumerStatefulWidget needs to call a service method in dispose() (e.g., to cancel an operation when the user leaves a screen), using ref.read() throws an error because the widget is already unmounted.

Context / Trigger Conditions

  • Error message: Using ref when widget is unmounted is unsafe
  • Using ConsumerStatefulWidget with ConsumerState
  • Calling ref.read(someProvider) inside dispose()
  • Widget navigates away (pop, push replacement, etc.)
  • Stack trace shows the error originating from dispose()

Example problematic code:

@override
void dispose() {
  ref.read(authServiceProvider).cancelOperation();  // ERROR!
  super.dispose();
}

Solution

Step 1: Add a late final field for the service

class _MyScreenState extends ConsumerState<MyScreen> {
  late final MyService _myService;  // Cache here

Step 2: Initialize in initState

@override
void initState() {
  super.initState();
  _myService = ref.read(myServiceProvider);  // Safe here
}

Step 3: Use cached reference in dispose

@override
void dispose() {
  _myService.cancelOperation();  // Use cached reference
  super.dispose();
}

Verification

  1. Navigate to the screen
  2. Navigate away (back button, push replacement, etc.)
  3. No "Using ref when widget is unmounted" error in console
  4. The cleanup action (cancel, close, etc.) still executes

Example

Before (causes error):

class _NostrConnectScreenState extends ConsumerState<NostrConnectScreen> {
  @override
  void dispose() {
    // ERROR: ref is not safe to use here
    ref.read(authServiceProvider).cancelNostrConnect();
    super.dispose();
  }
}

After (works correctly):

class _NostrConnectScreenState extends ConsumerState<NostrConnectScreen> {
  // Cache AuthService for use in dispose (can't use ref.read in dispose)
  late final AuthService _authService;

  @override
  void initState() {
    super.initState();
    _authService = ref.read(authServiceProvider);
  }

  @override
  void dispose() {
    // Cancel the session if user leaves the screen
    _authService.cancelNostrConnect();
    super.dispose();
  }
}

Notes

  • This pattern is necessary because Riverpod's ref is tied to the widget lifecycle
  • ref.read() is safe in initState() because the widget is being mounted
  • ref.read() is NOT safe in dispose() because the widget is being unmounted
  • The late final pattern ensures the service is initialized exactly once
  • This applies to any cleanup that requires calling methods on providers
  • For simple provider state changes (not method calls), consider using deactivate() instead
  • If the service itself might be disposed, add null checks or try-catch as appropriate

Related Skills

  • flutter-dispose-timer-test-failure: For timer-related dispose issues
  • flutter-deactivate-setstate-during-build: For setState/build cycle issues in deactivate

References

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

argocd-externalsecret-namespace-permission

Free

Fix ArgoCD ExternalSecret deployment failing with "namespace X is not permitted in project Y". Use when: (1) ExternalSecret shows OutOfSync in ArgoCD but won't sync, (2) ArgoCD application status shows "namespace X is not permitted in project 'infrastructure'", (3) ExternalSecret targets a namespace managed by a different ArgoCD project, (4) Using apps-of-apps pattern with separate infrastructure and application projects.

The English summary is being prepared. Showing the original description.

divinevideo/divine-mobile265Updated Oct 22, 2026

art-direct

Free

Art direction for any content — reads text, PDF, Word, HTML, PPT, then proposes 2-3 creative directions with photography style, mood, and visual language. After selection, generates AI image prompts and visual briefs section-by-section. Use when the user shares content and needs visual direction, image sourcing, or creative direction for any material.

The English summary is being prepared. Showing the original description.

divinevideo/divine-mobile265Updated Oct 22, 2026

async-await-null-race-condition

Free

Fix "Null check operator used on a null value" errors when an object is set to null during an async await. Use when: (1) Object reference is nullified while awaiting, (2) Code accesses object with ! after await returns, (3) Cancel/dispose operations run concurrently with async operations on same object. Solution: capture local reference before await.

The English summary is being prepared. Showing the original description.

divinevideo/divine-mobile265Updated Oct 22, 2026

aws-v4-signing-custom-headers-gcs

Free

Add custom metadata headers (x-amz-meta-*) to AWS v4 signed requests for GCS S3-compatible API. Use when: (1) Adding custom metadata to GCS uploads via S3 API, (2) Getting signature mismatch errors after adding new headers, (3) x-amz-meta-* headers being ignored or causing 403 errors. Custom headers MUST be included in canonical headers and signed headers list.

The English summary is being prepared. Showing the original description.

divinevideo/divine-mobile265Updated Oct 22, 2026

bash-herestring-newline-secrets

Free

Fix password/secret authentication failures caused by trailing newlines when creating Google Cloud secrets (or similar) with bash here-strings. Use when: (1) Password authentication fails with correct password, (2) Secret created with `<<< "value"` syntax, (3) Error like "password authentication failed" or "invalid token" despite correct value. Bash here-strings (`<<<`) add a trailing newline that corrupts secrets.

The English summary is being prepared. Showing the original description.

divinevideo/divine-mobile265Updated Oct 22, 2026

blossom-content-addressed-url-filtering

Free

Fix silent video/media processing failures caused by URL extraction code that filters on file extensions (.mp4, .webm, .webp). Use when: (1) Media moderation, transcoding, or analysis silently skips files from Blossom or content-addressed storage servers, (2) URL extraction from Nostr event tags (imeta, r tags) drops URLs without recognized extensions, (3) CDN fallback URLs append .mp4 but the actual server uses extensionless content-addressed paths like /{sha256}. Common in Nostr video events (kind 34236) where different clients use different URL formats.

The English summary is being prepared. Showing the original description.

divinevideo/divine-mobile265Updated Oct 22, 2026

See all skills by divinevideo

Report a problem with this skill