Convex Test

by get-convex2cfe645c87f9No licenseListed Oct 8, 2026Updated Oct 8, 2026

Generate convex-test tests for the app's Convex functions.

AI-generated overview

Generates convex-test and vitest tests for an app's Convex functions, covering auth, errors, indexes and scheduled functions.

What it does: This skill guides the creation of automated tests for Convex backend functions using convex-test with vitest against an in-memory backend. It walks through installing the tools, seeding data via t.run, calling t.query and t.mutation, and asserting on arguments and return values. It also covers authentication paths with withIdentity, error paths, and scheduled functions via t.finishInProgressScheduledFunctions. The output is a deterministic test suite run with vitest.
When to use it: Use it when a Convex project needs test coverage for its queries, mutations and scheduled functions. It fits situations where tests should run in memory rather than against a live deployment, and where auth and error paths must be verified alongside the happy path.
Requirements: Requires a Convex project plus the convex-test and vitest packages installed. Tests run against an in-memory backend, so no live deployment or network access is needed. The skill ships no scripts; it is instructions only.

Generate Convex tests

Use convex-test + vitest to test functions against an in-memory backend: args/returns, auth paths, indexes, and scheduled functions.

Install convex-test + vitest.
Write tests using convexTest(schema): seed via t.run, call t.query/t.mutation, assert.
Cover auth (withIdentity), error paths, and scheduled functions (t.finishInProgressScheduledFunctions).
Run vitest; keep tests deterministic.

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.