Gray Matter LogoGray Matter Workshop

Project Setup

KEY CONCEPT

Project Setup - Launching Your Codebase

Step-by-step guide to creating a new WPILib project. This workshop's robot code is built on Commands v3 + OpModes, so the starting point is the team's 2027-Template, which already organizes your code into mechanisms and OpModes.

↳ TAKEAWAY

Start from the Commands v3 / OpMode project so your code is organized into mechanisms and OpModes from day one.

NOTE

This workshop targets the 2027 alpha (Commands v3 + OpModes)

The robot code uses Commands v3 + the OpMode framework, runs on Java 25, and deploys to SystemCore. The workshop's canonical starting point is the team's 2027-Template repo — clone it (the default 2027-dev branch has the 2027 stack; the main branch is still the older 2026 stack) so you start with the OpMode wiring already in place, then set your team number in .wpilib/wpilib_preferences.json. The site mirrors the 2027 alpha stack (GradleRIO 2027.0.0-alpha-6, Phoenix 6 26.50.0-alpha-1).

Creating a New WPILib Project

Follow these step-by-step instructions to create a new FRC robot project using the Command Robot Skeleton (Advanced) template.

1

Open VSCode

Launch Visual Studio Code with the WPILib extension installed.

2

Select the WPILib Logo in Top Right Corner

Click on the WPILib logo/icon in the top right corner of VSCode.

3

Select "Create a New Project"

From the WPILib menu, choose the "Create a new project" option.

4

Select "Select a project type (Example or Template)"

Choose Template → Java → Command Robot Skeleton (Advanced). Note: for the 2027 OpMode structure this workshop teaches, start from the 2027-Template as noted above.

5

Base folder select "Downloads"

Warning

OneDrive locations are not supported and will cause project creation to fail.
6

Project Name "Workshop"

Enter "Workshop" as your project name.

7

Team Number

Enter your FRC team number. This is required for deploying code to your robot.

8

Check "Enable Desktop Support"

This allows you to test your robot code on your computer without a robot.

9

Generate Project

Click "Generate Project" and then open the new project when prompted.

Next Step

After creating your project, the next section covers the Command-Based Framework, where you'll start adding subsystems and commands.
CHECKPOINT · 4 ITEMS