@sebastienrousseau/dotfiles/docs/manual/05-appendices/A-platform-matrix.md

The Trusted Shell Platform — Universal dotfiles managed by Chezmoi. Features Bash & Zsh for macOS, Linux & WSL. Rust modern tooling & enterprise-grade security.

---
render_with_liquid: false
---

# Appendix A: Platform Support Matrix

## Supported Platforms

| OS | Version | Support | Notes |
|:---|:---|:---:|:---|
| macOS | 14 (Sonoma) | ✓ full | Primary development platform |
| macOS | 15 (Sequoia) | ✓ full | |
| macOS | 26 (Tahoe) | ✓ full | |
| Ubuntu | 22.04 LTS | ✓ full | |
| Ubuntu | 24.04 LTS | ✓ full | CI reference platform |
| Debian | 12 (Bookworm) | ✓ full | |
| Debian | 13 (Trixie) | ✓ full | |
| Arch Linux | rolling | ✓ full | |
| CachyOS | rolling | ✓ full | Arch-based |
| Fedora | 39 | ✓ | Less tested |
| Fedora | 40, 41 | ✓ | Less tested |
| openSUSE | Tumbleweed | ✓ | Less tested |
| Alpine | 3.20 | ⚠ partial | POSIX shells only; no Fish |
| WSL2 | Ubuntu 22.04+ | ✓ full | Windows 11 host |
| WSL2 | Debian | ✓ full | |
| Windows PowerShell | 7.5+ | ⚠ baseline | Aliases + prompt; no chezmoi |
| FreeBSD | 14 | ✗ untested | |
| Termux (Android) | latest | ✗ untested | |

## Supported Shells

| Shell | Version | Support |
|:---|:---|:---:|
| Fish | 3.6+ | ✓ primary |
| Zsh | 5.9+ | ✓ full |
| Bash | 5.0+ | ✓ full |
| Nushell | 0.90+ | ✓ full |
| PowerShell | 7.5+ | ⚠ baseline |

## Supported Architectures

| Arch | Status |
|:---:|:---:|
| amd64 / x86_64 | ✓ |
| arm64 / aarch64 | ✓ |
| armv7 | ⚠ best-effort |
| riscv64 | ✗ untested |

## Required Binaries

| Binary | Purpose | Install |
|:---|:---|:---|
| `git` | Version control | System package manager |
| `curl` | Installer | System package manager |
| `chezmoi` | Template engine | Installer downloads verified binary |

## Optional Binaries (installed by Mise on first apply)

| Binary | Purpose |
|:---|:---|
| `mise` | Runtime version manager |
| `age` | Secret encryption |
| `sops` | YAML secret encryption |
| `pandoc` | Manual generation |
| `shellcheck` | Shell linting |
| `shfmt` | Shell formatting |
| `starship` | Prompt |
| `fzf` | Fuzzy finder |
| `zoxide` | Smart `cd` |
| `atuin` | Shell history sync |
| `delta` | Git diff pager |
| `lazygit` | TUI Git client |
| `neovim` | Editor |

## Tested CI Environments

| Environment | Workflow |
|:---|:---|
| macOS 14 (GHA) | `ci.yml`, `ci-enforced.yml` |
| Ubuntu 24.04 (GHA) | `ci.yml`, `ci-enforced.yml` |
| GitHub Codespaces | `devcontainer-prebuild.yml` |
| Docker Ubuntu 24.04 | `ci.yml` test-docker job |

## Feature Matrix

| Feature | macOS | Linux | WSL2 |
|:---|:---:|:---:|:---:|
| Shell configs (zsh/fish/bash/nu) | ✓ | ✓ | ✓ |
| Terminal emulator configs | ✓ | ✓ | ✗ (host handles) |
| Theme engine (K-Means) | ✓ | ✓ | ✓ |
| Dynamic HEIC dark/light | ✓ native | ⚠ HEIC→PNG converted | ✗ |
| Neovim + LSP | ✓ | ✓ | ✓ |
| AI tools (Claude, Codex, etc.) | ✓ | ✓ | ✓ |
| MCP policy enforcement | ✓ | ✓ | ✓ |
| Attestation | ✓ | ✓ | ✓ |
| Fleet (SSH-based) | ✓ | ✓ | ⚠ |
| AeroSpace (WM) | ✓ | ✗ | ✗ |
| Niri (WM) | ✗ | ✓ | ✗ |
| GNOME gsettings | ✗ | ✓ | ⚠ |
| Build artifact redirect | ✓ | ✓ | ✓ |
| Self-healing (`dot heal`) | ✓ | ✓ | ✓ |