The 2026 Spectrum codebase uses Gradle as its build system, with Spotless for automatic code formatting, SpotBugs for static analysis, and Lombok for boilerplate reduction. These tools run automatically on every build, keeping code quality consistent across all contributors.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/spectrum3847/2026-Spectrum/llms.txt
Use this file to discover all available pages before exploring further.
Gradle
Gradle is the build system used by WPILib for all FRC Java projects. It handles compilation, dependency resolution, and deployment to the RoboRIO.Common Gradle tasks
Spotless
Spotless automatically formats all Java source files to the AOSP (Android Open Source Project) code style every time the project is built. You don’t need to manually format code — just build and Spotless handles it.- Enforces 4-space indentation
- Applies consistent brace and import ordering
- Runs on every
./gradlew buildcall
If a build fails with a Spotless formatting error, run
./gradlew spotlessApply to auto-fix all formatting issues, then rebuild.SpotBugs
SpotBugs performs static analysis on compiled bytecode to catch common bugs before they reach the robot.- Catches mistakes like using
=instead of==in conditionals - Identifies unreachable code and incorrect method calls
- Currently configured for a low report level (fewer false positives)
- SpotBugs HTML reports can be opened with the Open in Browser VS Code extension
Lombok
Project Lombok uses Java annotations to generate boilerplate code at compile time, keeping source files concise.java
@Getter annotation generates a getVelocityRPM() method; @Setter generates setVelocityRPM(double). No manual getter/setter code needed. See Class and Method Patterns for full Lombok usage.
VS Code extensions
Essential extensions
Essential extensions
- Language Support for Java™ by Red Hat (
redhat.java) — IntelliSense, code navigation, refactoring. Use “Clean Java Language Server Workspace” when seeing false errors. - Error Lens (
usernamehw.errorlens) — Highlights errors inline in the editor - WPILib — Integrated WPILib commands, simulation launcher, and deploy
Git and collaboration
Git and collaboration
- GitLens (
eamodio.gitlens) —git blame, commit history, and diff views inline - GitHub Pull Requests and Issues — Manage PRs and issues without leaving VS Code
- Git Config User Profiles — Multiple team members can commit from one machine under their own names
- Live Share (
ms-vsliveshare.vsliveshare) — Real-time pair programming
AI assistance
AI assistance
- GitHub Copilot — Inline code completion suggestions (press Tab to accept)
- Copilot Chat — Conversational AI assistant for code questions and generation
- IntelliCode (
VisualStudioExptTeam.vscodeintellicode) — Context-aware completions
Productivity
Productivity
- Spell Right (
Ban.spellright) — Spell checker for comments and strings - Open in Browser — Open SpotBugs HTML output directly from VS Code
- Ctrl+Shift+P → type
simto launch WPILib simulation from any file
