Setting the chapter. One moment.
Skills
Chapter 2 of 20
Build the Convex project from source. Use when a contributor wants to compile, test, or package Convex.
1 minute · 149 words · 3 sections
Build the Convex Maven project. Requires Java 21+ (JDK 25 recommended) and Maven 3.7+.
Run every command from the repository root — that is already the working
directory, so do not cd anywhere first. Use ./mvnw in preference to mvn
when the wrapper is present, so the build uses the pinned Maven version.
Parse $ARGUMENTS for two things:
convex-), e.g. convex-core--test flagThe default when no arguments are given:
./mvnw -B./mvnw -B clean install -DskipTests -pl <module> -am-am also builds the modules that one depends on.
When --test is present, or the user asks for tests, drop -DskipTests. This
matches what CI runs, so it is the command to use before claiming work is done:
./mvnw -B clean installFor a single module’s tests:
./mvnw -B test -pl <module> -amReport the result — success or failure — and any errors, concisely. On failure, quote the first real compilation or test error rather than the Maven summary.
Install this repository
npx skills add Convex-Dev/convexSkills install per repository, not per chapter — the CLI has no documented per-skill form, so we do not print one.
Bash.claude/skills/build-convex/SKILL.mddevelop, last pushed 10 August 2026.SKILL.md, not by matching a directory convention. One layout observed: .claude/skills/*/SKILL.md.h1 and no skipped levels:/Convex-Dev/convex.md, and each chapter at its own .md URL.