dotfiles

A clean, modern Zsh setup with Oh My Zsh and Starship prompt, tailored for developers.

Supports Linux (openSUSE Tumbleweed / Ubuntu) and WSL.

Features

• Shell: Zsh + Oh My Zsh
• Prompt: Starship
• Plugins: zsh-autosuggestions, zsh-syntax-highlighting, zsh-completions
• Modern CLI Tools:
  • eza (better ls)
  • bat (better cat)
  • fzf (fuzzy finder)
  • ripgrep (better grep)
  • fd (better find)
  • delta (better git diff)
• Development Managers: nvm (Node), pyenv (Python), uv (Python), rustup (Rust)
• Containers: Podman, Buildah, Distrobox, Docker (on Native Linux)

Installation

Clone the repository to your preferred location (e.g., ~/Projects/dotfiles):

git clone git://github.com/kayaman/dotfiles.git ~/Projects/dotfiles
cd ~/Projects/dotfiles

Native Linux (openSUSE / Ubuntu)

Installs the full suite of CLI tools, dev environments, and container engines (Podman & Docker).

chmod +x install.sh
./install.sh

WSL (Windows Subsystem for Linux)

A slimmer installation for WSL environments (e.g., Ubuntu/Debian on WSL). Skips desktop-specific components and container daemons.

chmod +x wsl/install.sh
./wsl/install.sh

Structure

dotfiles/
├── install.sh                    # Main installer for Native Linux (openSUSE/Ubuntu)
├── wsl/
│   └── install.sh                # Dedicated installer for WSL
├── stow/                         # Stow packages for symlinking
│   ├── zsh/                      # .zshrc, .aliases, .functions, .path
│   ├── git/                      # .gitconfig
│   ├── starship/                 # starship.toml
│   ├── ripgrep/                  # ripgrep config
│   ├── kitty/                    # kitty.conf
│   └── ghostty/                  # ghostty config
├── snippets/                     # Additional shell scripts auto-sourced by .zshrc
├── scripts/                      # Setup scripts
└── README.md

Customization

• Snippets: Add any .sh file to the snippets/ directory, and it will be automatically sourced by .zshrc.
• Aliases: Edit stow/zsh/.aliases for your custom command shortcuts.
• Functions: Add reusable functions to stow/zsh/.functions.
• Configuration & Secrets: Copy dotfiles.toml.example to dotfiles.toml to manage your Git identity, API tokens, and feature toggles:

  cp dotfiles.toml.example dotfiles.toml
  # Edit dotfiles.toml with your favorite editor

  Advanced: For encrypted secrets, create dotfiles.sops.toml and encrypt it using SOPS. If present, it will take precedence and securely decrypt values on-the-fly. Values in the [secrets] section are automatically exported as environment variables.
• Environment: Use .env or .env.sh (ignored by git) in your home directory for machine-specific secrets and tokens not managed via SOPS.

After Installation

1. Restart your terminal or run exec zsh.
2. Configure your favorite terminal emulator to use a Nerd Font (e.g., JetBrains Mono Nerd Font) to correctly render Starship prompt symbols.
3. Configure your Git user and GPG signing preferences by running:

   ./scripts/setup-git.sh