# firebots-software/2026-rebuilt-systemcore architecture

> Architecture diagram of the GitHub repository firebots-software/2026-rebuilt-systemcore, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/firebots-software/2026-rebuilt-systemcore
- Repository: https://github.com/firebots-software/2026-rebuilt-systemcore
- Video tour (about a minute): https://gitdiagram.com/firebots-software/2026-rebuilt-systemcore/video

## Overview

This is a command-based FRC robot application. Robot startup creates the hardware and command container; operator controls and autonomous routines schedule drivetrain, intake, hopper, and shooter actions, while vision updates drivetrain localization. Autonomous path selection and teleoperated control are distinct operating modes. The graph reflects explicit calls and imports in the supplied excerpts and source index; unsampled subsystem behavior and some runtime wiring are left unconnected where evidence is limited.

Main entry points: [`src/main/java/frc/robot/RobotContainer.java`](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/RobotContainer.java) (Robot Container), [`src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java`](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java) (Swerve Drivetrain), [`src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java`](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java) (Aim And Shoot), [`src/main/java/frc/robot/AutoRoutines.java`](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/AutoRoutines.java) (Autonomous Routines)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Robot Runtime"]
  node_robot["Robot Lifecycle<br/>[Robot.java]"]
  node_container["Robot Container"]
end

subgraph group_operation["Operating Modes"]
  node_teleop["Teleop Mode<br/>[MatchTeleop.java]"]
  node_baseop["Base Op Mode<br/>[BaseOpMode.java]"]
  node_autos["Autonomous Routines<br/>[AutoRoutines.java]"]
  node_auto_modes["Autonomous Modes"]
  node_intake_bump["Intake To Bump"]
  node_shoot_bump["Shoot To Bump"]
end

subgraph group_motion["Drive And Vision"]
  node_drive_cmd["Pose Driving<br/>[DriveToPose.java]"]
  node_swerve_cmd["Joystick Driving"]
  node_drive["Swerve Drivetrain"]
  node_vision["Robot Vision"]
  node_fuel_detect["Fuel Detection"]
  node_intake_detect["Intake Vision"]
  node_vision_utils["Vision Fusion<br/>[VisionUtils.java]"]
end

subgraph group_mechanisms["Game Mechanisms"]
  node_intake["Intake Mechanism"]
  node_hopper["Hopper Mechanism"]
  node_shooter["Shooter Mechanism"]
  node_shoot_aim["Aim And Shoot<br/>[ShootWithAim.java]"]
  node_drive_shoot["Drive And Shoot"]
end

subgraph group_aiming["Targeting And Support"]
  node_targeting["Shot Targeting<br/>[Targeting.java]"]
  node_constants["Robot Configuration<br/>[Constants.java]"]
  node_led["Status LEDs<br/>[LEDSubsystem.java]"]
  node_controller["Controller Adapter"]
end

node_driver(("Operator"))
node_field(("Field Vision"))

node_robot -->|"creates"| node_container
node_robot -->|"runs periodic"| node_container
node_container -->|"creates"| node_drive
node_container -->|"creates"| node_intake
node_container -->|"creates"| node_hopper
node_container -->|"creates"| node_shooter
node_container -->|"creates"| node_vision
node_container -->|"creates"| node_fuel_detect
node_container -->|"creates"| node_intake_detect
node_container -->|"updates indicators"| node_led
node_container -->|"runs vision periodic"| node_vision_utils
node_vision_utils -->|"fuses measurements"| node_drive
node_robot -->|"provides container"| node_baseop
node_baseop -->|"reads pose"| node_container
node_container -->|"sets default drive"| node_swerve_cmd
node_driver -.->|"operates"| node_teleop
node_teleop -.->|"uses controls"| node_container
node_auto_modes -->|"extends"| node_baseop
node_auto_modes -.->|"selects routines"| node_autos
node_autos -->|"creates path factory"| node_drive
node_autos -->|"builds shooting routine"| node_shoot_aim
node_autos -->|"schedules intake drive"| node_intake_bump
node_autos -->|"schedules shooting drive"| node_shoot_bump
node_intake_bump -->|"uses pose drive"| node_drive_cmd
node_intake_bump -->|"requires drivetrain"| node_drive
node_shoot_bump -->|"uses pose drive"| node_drive_cmd
node_drive_cmd -->|"reads pose and drives"| node_drive
node_swerve_cmd -->|"sends drive requests"| node_drive
node_shoot_aim -->|"commands shooter"| node_shooter
node_shoot_aim -->|"runs hopper"| node_hopper
node_shoot_aim -->|"retracts intake"| node_intake
node_shoot_aim -->|"uses joystick drive"| node_swerve_cmd
node_shoot_aim -->|"gets target pose"| node_drive
node_shoot_aim -->|"aims at target"| node_targeting
node_drive_shoot -->|"requires drivetrain"| node_drive
node_drive_shoot -->|"uses targeting"| node_targeting
node_drive -->|"computes virtual target"| node_targeting
node_targeting -->|"reads field state"| node_drive
node_shooter -->|"uses shot calculations"| node_targeting
node_container -->|"creates controller"| node_controller
node_container -->|"configures subsystems"| node_constants
node_field -.->|"supplies observations"| node_vision

click node_robot "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/Robot.java"
click node_container "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/RobotContainer.java"
click node_teleop "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/opModes/MatchTeleop.java"
click node_baseop "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/opModes/BaseOpMode.java"
click node_autos "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/AutoRoutines.java"
click node_auto_modes "https://github.com/firebots-software/2026-rebuilt-systemcore/tree/main/src/main/java/frc/robot/opModes/autos"
click node_drive_cmd "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commands/DriveToPose.java"
click node_swerve_cmd "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commands/SwerveCommands/SwerveJoystickCommand.java"
click node_drive "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java"
click node_vision "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/VisionSubsystem.java"
click node_fuel_detect "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/FuelGaugeDetection.java"
click node_intake_detect "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/IntakeVisionDetection.java"
click node_vision_utils "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/util/VisionUtils.java"
click node_intake "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/IntakeSubsystem.java"
click node_hopper "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/HopperSubsystem.java"
click node_shooter "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/ShooterSubsystem.java"
click node_shoot_aim "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java"
click node_drive_shoot "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/ShootCommandGroups/DriveToAndShoot.java"
click node_intake_bump "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/IntakeToBumpDTP.java"
click node_shoot_bump "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/ShootToBumpDTP.java"
click node_targeting "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/util/Targeting.java"
click node_constants "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/Constants.java"
click node_led "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/LEDSubsystem.java"
click node_controller "https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/util/CustomController.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_robot,node_container toneBlue
class node_teleop,node_baseop,node_autos,node_auto_modes,node_intake_bump,node_shoot_bump toneAmber
class node_drive_cmd,node_swerve_cmd,node_drive,node_vision,node_fuel_detect,node_intake_detect,node_vision_utils toneMint
class node_intake,node_hopper,node_shooter,node_shoot_aim,node_drive_shoot toneRose
class node_targeting,node_constants,node_led,node_controller,node_driver,node_field toneIndigo
```

## Components

### Robot Runtime

- [Robot Lifecycle](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/Robot.java): `src/main/java/frc/robot/Robot.java`
- [Robot Container](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/RobotContainer.java): `src/main/java/frc/robot/RobotContainer.java`

### Operating Modes

- [Teleop Mode](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/opModes/MatchTeleop.java): `src/main/java/frc/robot/opModes/MatchTeleop.java`
- [Base Op Mode](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/opModes/BaseOpMode.java): `src/main/java/frc/robot/opModes/BaseOpMode.java`
- [Autonomous Routines](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/AutoRoutines.java): `src/main/java/frc/robot/AutoRoutines.java`
- [Autonomous Modes](https://github.com/firebots-software/2026-rebuilt-systemcore/tree/main/src/main/java/frc/robot/opModes/autos): `src/main/java/frc/robot/opModes/autos`
- [Intake To Bump](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/IntakeToBumpDTP.java): `src/main/java/frc/robot/commandGroups/IntakeToBumpDTP.java`
- [Shoot To Bump](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/ShootToBumpDTP.java): `src/main/java/frc/robot/commandGroups/ShootToBumpDTP.java`

### Drive And Vision

- [Pose Driving](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commands/DriveToPose.java): `src/main/java/frc/robot/commands/DriveToPose.java`
- [Joystick Driving](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commands/SwerveCommands/SwerveJoystickCommand.java): `src/main/java/frc/robot/commands/SwerveCommands/SwerveJoystickCommand.java`
- [Swerve Drivetrain](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java): `src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java`
- [Robot Vision](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/VisionSubsystem.java): `src/main/java/frc/robot/subsystems/VisionSubsystem.java`
- [Fuel Detection](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/FuelGaugeDetection.java): `src/main/java/frc/robot/subsystems/FuelGaugeDetection.java`
- [Intake Vision](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/IntakeVisionDetection.java): `src/main/java/frc/robot/subsystems/IntakeVisionDetection.java`
- [Vision Fusion](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/util/VisionUtils.java): `src/main/java/frc/robot/util/VisionUtils.java`

### Game Mechanisms

- [Intake Mechanism](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/IntakeSubsystem.java): `src/main/java/frc/robot/subsystems/IntakeSubsystem.java`
- [Hopper Mechanism](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/HopperSubsystem.java): `src/main/java/frc/robot/subsystems/HopperSubsystem.java`
- [Shooter Mechanism](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/ShooterSubsystem.java): `src/main/java/frc/robot/subsystems/ShooterSubsystem.java`
- [Aim And Shoot](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java): `src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java`
- [Drive And Shoot](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/commandGroups/ShootCommandGroups/DriveToAndShoot.java): `src/main/java/frc/robot/commandGroups/ShootCommandGroups/DriveToAndShoot.java`

### Targeting And Support

- [Shot Targeting](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/util/Targeting.java): `src/main/java/frc/robot/util/Targeting.java`
- [Robot Configuration](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/Constants.java): `src/main/java/frc/robot/Constants.java`
- [Status LEDs](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/subsystems/LEDSubsystem.java): `src/main/java/frc/robot/subsystems/LEDSubsystem.java`
- [Controller Adapter](https://github.com/firebots-software/2026-rebuilt-systemcore/blob/main/src/main/java/frc/robot/util/CustomController.java): `src/main/java/frc/robot/util/CustomController.java`

### Other components

- **Operator**
- **Field Vision**

## Connections

- Robot Lifecycle → Robot Container: creates (evidence: `src/main/java/frc/robot/Robot.java`)
- Robot Lifecycle → Robot Container: runs periodic (evidence: `src/main/java/frc/robot/Robot.java`)
- Robot Container → Swerve Drivetrain: creates (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Intake Mechanism: creates (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Hopper Mechanism: creates (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Shooter Mechanism: creates (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Robot Vision: creates (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Fuel Detection: creates (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Intake Vision: creates (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Status LEDs: updates indicators (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Vision Fusion: runs vision periodic (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Vision Fusion → Swerve Drivetrain: fuses measurements (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Lifecycle → Base Op Mode: provides container (evidence: `src/main/java/frc/robot/opModes/BaseOpMode.java`)
- Base Op Mode → Robot Container: reads pose (evidence: `src/main/java/frc/robot/opModes/BaseOpMode.java`)
- Robot Container → Joystick Driving: sets default drive (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Operator → Teleop Mode: operates
- Teleop Mode → Robot Container: uses controls
- Autonomous Modes → Base Op Mode: extends (evidence: `src/main/java/frc/robot/opModes/autos/HubSweepLeft.java`)
- Autonomous Modes → Autonomous Routines: selects routines (evidence: `src/main/java/frc/robot/AutoRoutines.java`)
- Autonomous Routines → Swerve Drivetrain: creates path factory (evidence: `src/main/java/frc/robot/AutoRoutines.java`)
- Autonomous Routines → Aim And Shoot: builds shooting routine (evidence: `src/main/java/frc/robot/AutoRoutines.java`)
- Autonomous Routines → Intake To Bump: schedules intake drive (evidence: `src/main/java/frc/robot/AutoRoutines.java`)
- Autonomous Routines → Shoot To Bump: schedules shooting drive (evidence: `src/main/java/frc/robot/AutoRoutines.java`)
- Intake To Bump → Pose Driving: uses pose drive (evidence: `src/main/java/frc/robot/commandGroups/IntakeToBumpDTP.java`)
- Intake To Bump → Swerve Drivetrain: requires drivetrain (evidence: `src/main/java/frc/robot/commandGroups/IntakeToBumpDTP.java`)
- Shoot To Bump → Pose Driving: uses pose drive (evidence: `src/main/java/frc/robot/commandGroups/ShootToBumpDTP.java`)
- Pose Driving → Swerve Drivetrain: reads pose and drives (evidence: `src/main/java/frc/robot/commands/DriveToPose.java`)
- Joystick Driving → Swerve Drivetrain: sends drive requests (evidence: `src/main/java/frc/robot/commands/SwerveCommands/SwerveJoystickCommand.java`)
- Aim And Shoot → Shooter Mechanism: commands shooter (evidence: `src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java`)
- Aim And Shoot → Hopper Mechanism: runs hopper (evidence: `src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java`)
- Aim And Shoot → Intake Mechanism: retracts intake (evidence: `src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java`)
- Aim And Shoot → Joystick Driving: uses joystick drive (evidence: `src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java`)
- Aim And Shoot → Swerve Drivetrain: gets target pose (evidence: `src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java`)
- Aim And Shoot → Shot Targeting: aims at target (evidence: `src/main/java/frc/robot/commandGroups/ShootCommandGroups/ShootWithAim.java`)
- Drive And Shoot → Swerve Drivetrain: requires drivetrain (evidence: `src/main/java/frc/robot/commandGroups/ShootCommandGroups/DriveToAndShoot.java`)
- Drive And Shoot → Shot Targeting: uses targeting (evidence: `src/main/java/frc/robot/commandGroups/ShootCommandGroups/DriveToAndShoot.java`)
- Swerve Drivetrain → Shot Targeting: computes virtual target (evidence: `src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java`)
- Shot Targeting → Swerve Drivetrain: reads field state (evidence: `src/main/java/frc/robot/util/Targeting.java`)
- Shooter Mechanism → Shot Targeting: uses shot calculations (evidence: `src/main/java/frc/robot/subsystems/ShooterSubsystem.java`)
- Robot Container → Controller Adapter: creates controller (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Robot Container → Robot Configuration: configures subsystems (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Field Vision → Robot Vision: supplies observations
