# Riverpod Overrides

> Override Riverpod providers for tests, debugging, or environment-specific behavior; ProviderScope and ProviderContainer overrides, overrideWith, overrideWithValue. Use when mocking providers in tests, injecting different implementations, or scoping provider behavior. Use this skill when the user asks about overrides, testing Riverpod, or mocking providers.

- Skill: `majiayu000/riverpod-overrides` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/riverpod-overrides`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/riverpod-overrides/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/riverpod-overrides

---


# Riverpod — Provider overrides

## Instructions

All providers can be **overridden** to change their behavior. Overrides are set on the **container** (ProviderScope in Flutter, ProviderContainer in Dart) via the `overrides` parameter. Use overrides for testing, debugging, different environments, or scoping (see riverpod-scoping).

### Where to set overrides

- **Flutter:** Pass `overrides` to `ProviderScope` (usually at the root or around a subtree).
- **Dart:** Pass `overrides` to `ProviderContainer`.

### Override methods

Each provider type exposes methods whose names start with `overrideWith`, for example:

- **overrideWith** — Provide a new implementation (e.g. a function that returns a value or builds state).
- **overrideWithValue** — Replace with a fixed value (e.g. for FutureProvider/StreamProvider).
- **overrideWithBuild** — Custom build logic (e.g. for StreamProvider).

Check the provider's API for the exact method (e.g. `Provider.overrideWith`, `FutureProvider.overrideWithValue`).

### Example: override a counter

```dart
// Flutter
void main() {
  runApp(
    ProviderScope(
      overrides: [
        counterProvider.overrideWith((ref) => 42),
      ],
      child: MyApp(),
    ),
  );
}

// Dart
final container = ProviderContainer(
  overrides: [
    counterProvider.overrideWith((ref) => 42),
  ],
);
```

### Family overrides

- **Single parameter:** Override one specific argument: `userProvider('123').overrideWith((ref) => User(name: 'User 123'))`.
- **All parameters:** Override the whole family: `userProvider.overrideWith((ref, arg) => User(name: 'User $arg'))`.

See riverpod-family and riverpod-testing for more test patterns.