Skip to content

Raider Aerospace Society Onboarding

Tooling

ras25-26/ras-handbook

Raider Aerospace Society Onboarding

ras25-26/ras-handbook

Home
Getting Started
Getting Started
- Terminal Basics
- GitHub
  GitHub
  - Account Setup
  - GitHub Website
- Git Basics
- VS Code
- Markdown
- PlatformIO
Team Standards
Team Standards
- Branching
- Commit Style
- Pull Requests
- Tooling Tooling
  Table of contents
Checklists
Checklists
- New Member
- Workstation Setup
FAQ

Tooling Standards¶

Why this page? Ensure every member has the same toolchain, formatting, and CI checks so contributions are consistent and reproducible.

Goals¶

Single‑command builds and uploads
Auto‑format + lint before code ever hits a PR
Editor settings that match CI
Clear minimum versions and where to get them
Define commands/setups for needed tools

Required Tools (minimum versions)¶

Git ≥ 2.39
VS Code (latest) with recommended extensions below
PlatformIO Core (installed by VS Code extension) for ESP32 projects
Python ≥ 3.10 (PlatformIO manages venvs automatically)
clang-format ≥ 16 (C/C++ formatting)
pre-commit ≥ 3 (git hook runner)
(optional) Make or Just for task shortcuts

Install clang-format via your OS package manager (e.g., brew install llvm on macOS, choco install llvm on Windows, apt install clang-format on Ubuntu).

Repo Conventions¶