# Software Development Setup
Opinionated, end-to-end guides for getting a machine ready to write code. Each guide stands on its own — pick the one that matches your platform.
## Guides
### [[Mac Tahoe Development Setup|Mac Tahoe (Apple Silicon)]]
A complete setup for an Apple Silicon Mac running macOS Tahoe (26): Homebrew, Git, GitHub CLI, Ghostty, Starship, VS Code, and Claude Code, plus per-language guides for Python, C, Ruby, Go, and Rust. Each language guide ends with a small project to confirm the toolchain end to end.
### [[Ubuntu Linux Development Setup|Ubuntu 26.04 (Intel/AMD + Arm)]]
The Linux counterpart: a complete setup for Ubuntu 26.04 LTS (Resolute Raccoon) using apt, Git, GitHub CLI, Ghostty, Starship, bash, VS Code, and Claude Code, plus the same per-language guides. Every tool installs identically on both `amd64` and `arm64`, so the instructions work in VMs on either architecture.
### [[Fedora Workstation Development Setup|Fedora Workstation 44 (Intel/AMD + Arm)]]
The RPM-based Linux counterpart: a complete setup for Fedora Workstation 44 using dnf, Git, GitHub CLI, Ghostty, Starship, bash, VS Code, and Claude Code, plus the same per-language guides. Same philosophy and layout as the Ubuntu guide, adapted to `dnf` (dnf5), COPR, and vendor RPM repos. Every tool installs identically on both `x86_64` and `aarch64`.
### [[Windows 11 Development Setup|Windows 11 (Intel/AMD + Snapdragon ARM64)]]
The Windows counterpart, with two paths: a [[WSL2 Windows Development Setup|WSL2 path]] that runs Ubuntu inside Windows and reuses the Linux guides, and a [[Native Windows Development Setup|fully-native path]] using winget, Windows Terminal, PowerShell 7, Starship, VS Code, and Claude Code with native per-language toolchains. Both paths work identically on ARM64 (Snapdragon, Surface Pro 11) and x64.
---
_More setup guides will be added here over time._