Installation

Add FrcCatalyst 1.12.0 to a WPILib 2026 roboRIO project. For Systemcore / WPILib 2027, use the RC1 installation guide and compatibility table.

Table of contents

  1. Prerequisites
  2. Option 1: Vendordep (Recommended)
  3. Option 2: JitPack (build.gradle)
  4. Option 3: Local Maven (From Source)
  5. Verify Installation
  6. Next Steps

Prerequisites

  • WPILib 2026 installed (download)
  • A GradleRIO robot project (created via WPILib project generator)
  • These vendordeps installed in your project (Catalyst builds on them): CTRE Phoenix 6, PathPlanner, and PhotonVision. Install them the usual way (Manage Vendor Libraries → Install new libraries online) with their official URLs.

The easiest install. In WPILib VS Code, open the command palette and run WPILib: Manage Vendor Libraries → Install new libraries (online), then paste:

https://tomas-1226.github.io/FrcCatalyst/vendordep/FrcCatalyst.json

That adds FrcCatalyst to your project and lets WPILib check for updates. Make sure the Phoenix 6, PathPlanner, and PhotonVision vendordeps are also installed (Catalyst depends on them).

This URL installs 1.12.0, the same version as Option 2. Versions and compatibility says which Catalyst runs on which robot.

Option 2: JitPack (build.gradle)

If you’d rather add it by hand, put the JitPack repository and the dependency in your robot project’s build.gradle:

repositories {
    // ... your existing repositories ...
    maven { url "https://jitpack.io" }
}

dependencies {
    // ... your existing dependencies ...
    implementation "com.github.TomAs-1226:FrcCatalyst:v1.12.0"
}

Option 3: Local Maven (From Source)

If you prefer to build from source or need to modify the library:

# Clone FrcCatalyst
git clone https://github.com/TomAs-1226/FrcCatalyst.git
cd FrcCatalyst

# Publish to local Maven
./gradlew publishToMavenLocal

Then in your robot project’s build.gradle:

repositories {
    mavenLocal()
}

dependencies {
    implementation "com.frccatalyst:FrcCatalyst:1.12.0"
}

Verify Installation

Create a simple test in your RobotContainer to confirm everything is working:

import frc.lib.catalyst.hardware.MotorType;
import frc.lib.catalyst.util.CatalystMath;

// In your RobotContainer constructor:
System.out.println("Kraken X60 free speed: "
    + MotorType.KRAKEN_X60.freeSpeedRPS() + " RPS");
System.out.println("Processed joystick: "
    + CatalystMath.processJoystick(0.5, 0.05, 2.0, 1.0));

If it compiles and prints the values, you’re good to go!

Next Steps

Head to the Quick Start guide to build your first mechanism in under 5 minutes.