@sebastienrousseau/dotfiles/docs/reference/FEATURES.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
---

# Feature Flags Reference

Feature flags let you turn parts of the dotfiles on or off. All flags live in `.chezmoidata.toml` under `[features]`. Set a flag to `true` to enable it, or `false` to disable it. Changes take effect after you run `dot apply`.

## Shell and Terminal

These flags control shell behavior and terminal tools.

| Flag | Default | Description |
|------|---------|-------------|
| `alias_wrapper` | `false` | Enable alias governance wrapper (confirms destructive aliases) |
| `dms` | `true` | Dank Material Shell theming for GNOME |
| `zellij` | `false` | Enable Zellij terminal multiplexer config |

## Linux Desktop

These flags enable Wayland desktop components. Turn them on if you run a Linux desktop with Niri or another tiling compositor.

| Flag | Default | Description |
|------|---------|-------------|
| `linux_desktop` | `false` | Enable full Linux desktop environment configs |
| `niri` | `false` | Niri Wayland compositor config |
| `waybar` | `false` | Waybar status bar config |
| `fuzzel` | `false` | Fuzzel application launcher config |
| `mako` | `false` | Mako notification daemon config |
| `foot` | `false` | Foot terminal emulator config |
| `kanshi` | `false` | Kanshi display manager config |

## Hardware

| Flag | Default | Description |
|------|---------|-------------|
| `touch` | `false` | Enable touchscreen support (gestures, on-screen keyboard) |
| `t2` | `false` | Apple T2 security chip handling |
| `surface` | `false` | Microsoft Surface hardware support |

## Tool Selection

| Setting | Default | Options |
|---------|---------|---------|
| `node_manager` | `mise` | `mise`, `fnm`, `nvm` |

## Alias Policy

| Setting | Default | Description |
|---------|---------|-------------|
| `aliases.buckets.system` | `true` | Enable system utility aliases |
| `aliases.buckets.svn` | `true` | Enable SVN aliases |
| `aliases.policy.strict_mode` | `false` | Require confirmation for destructive aliases (rm, mv) |

## How to Toggle Features

You can edit flags in two places. Change `.chezmoidata.toml` in the repo to set defaults for all machines. Or override on a single machine in `~/.config/chezmoi/chezmoi.toml`:

```bash
# In ~/.config/chezmoi/chezmoi.toml
[data.features]
zellij = true
linux_desktop = true
```

Then apply: `dot apply`