riverpod-mutations
Use Riverpod mutations for UI-driven async operations like form submit; Mutation.run, MutationIdle/Pending/Success/Error, Mutation.reset, keyed mutations. Use when showing loading/error/success for a single action (e.g. submit button) without polluting provider state. Use this skill when the user asks about mutations, loading state for actions, or form submission with Riverpod.
How do I install this agent skill?
npx skills add https://github.com/serverpod/skills-registry --skill riverpod-mutationsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides documentation and code examples for using Riverpod mutations in Flutter development. No security risks or malicious patterns were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Riverpod — Mutations (experimental)
Instructions
Mutations represent a single async operation the UI can react to (e.g. "add todo" in progress, succeeded, or failed). They keep loading/error/success out of your main provider state. The API is experimental and may change.
Defining a mutation
Create a Mutation<T> instance (T is the result type, optional):
final addTodo = Mutation<Todo>();
Typically store it as a global or static final on a Notifier.
Listening
Use ref.watch in a Consumer (or inside a provider) to drive the UI:
final addTodoState = ref.watch(addTodo);
// In build:
backgroundColor: switch (addTodoState) {
MutationError() => const WidgetStatePropertyAll(Colors.red),
_ => null,
},
if (addTodoState is MutationPending) ...[
const SizedBox(width: 8),
const CircularProgressIndicator(),
],
States
- MutationIdle — Not started or reset.
- MutationPending — In progress.
- MutationSuccess — Succeeded; result available.
- MutationError — Failed; error available.
Use a switch on the state to handle each case.
Triggering
Call Mutation.run(ref, callback). The callback receives a transaction object (e.g. tsx) to access providers and must return a value of type T:
addTodo.run(ref, (tsx) async {
final todoNotifier = tsx.get(todoNotifierProvider.notifier);
final createdTodo = await todoNotifier.addTodo('Eat a cookie');
return createdTodo;
});
Use tsx.get(provider) to keep providers alive for the duration of the mutation.
Keyed mutations
Pass a key to have multiple instances (e.g. one mutation per list item):
ref.watch(deleteItemMutation(itemId));
deleteItemMutation(itemId).run(ref, (tsx) async { ... });
Resetting
Mutations reset to Idle when they complete or when all listeners are removed. To reset manually:
addTodo.reset(ref);
See the official Riverpod docs for the latest mutation API and generics.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/serverpod/skills-registry/riverpod-mutations">View riverpod-mutations on skillZs</a>