convex-mutations

What problem does it solve?

This skill standardizes and accelerates the creation of Convex mutation functions by providing best practices, patterns, and tooling guidance for defining, registering, and scheduling mutations, including transaction semantics and error handling.

Core Features & Use Cases

• Guided mutation function definitions with validators and file-based routing.
• Reference-driven workflow spanning definition, registration (mutation and internalMutation), and mutation calls from queries.
• Scheduling support using ctx.scheduler.runAfter and transactional guarantees.
• Comprehensive mutation guidelines with examples and patterns, including database operations (insert, patch, replace) and error handling.
• Real-world example: define a "sendMessage" mutation and schedule a response to run after a delay.

Quick Start

Review the reference documentation at references/mutation-guidelines.md to implement a sample mutation following the patterns described. Then create a simple mutation in your Convex project and validate it against the guidelines.