Dotfiles

Personal configuration files for my Linux development environment.

Quick Start

# 1. Install prerequisites
sudo pacman -S git stow  # Arch
# sudo apt install git stow  # Ubuntu/Debian
# sudo dnf install git stow  # Fedora

# 2. Clone and install
git clone git@github.com:gabrielcastr0/dotfiles.git ~/dotfiles
cd ~/dotfiles

# 3. Install dependencies (see Dependencies section below)

# 4. Stow configurations
stow -t ~ */

What's Included

Config	Description
Neovim	Lazy.nvim, LSP, Treesitter, Telescope, nvim-cmp, and more
Tmux	TPM, Catppuccin theme, session management, vim-tmux navigation
Zsh	Oh-My-Zsh, Starship prompt, vi mode, shell enhancements
Starship	Custom prompt configuration
Kitty	Terminal emulator config
Ghostty	Terminal emulator config (Rosé Pine theme, tmux-like keybinds)
Zed	Code editor settings
Scripts	Custom utilities (fzf-git, tmux-sessionizer, etc.)

Dependencies

Install dependencies before running stow. Choose your distro below.

Arch Linux

# Core tools
sudo pacman -S zsh tmux neovim starship git stow

# Shell enhancements
sudo pacman -S zoxide fzf fd ripgrep bat eza tree lazygit yazi xclip

# Build tools & development
sudo pacman -S base-devel go stylua

# Fonts
sudo pacman -S ttf-jetbrains-mono-nerd

# AUR packages
yay -S atuin

Fedora

# Core tools
sudo dnf install zsh tmux neovim git stow

# Starship (not in Fedora repos)
curl -sS https://starship.rs/install.sh | sh

# Eza (retired from official repos in Fedora 42+, use COPR)
sudo dnf copr enable alternateved/eza -y
sudo dnf install eza

# Shell enhancements
sudo dnf install zoxide fzf fd-find ripgrep bat tree golang

# Clipboard tools
sudo dnf install wl-clipboard  # For Wayland (GNOME 49+ default)
# sudo dnf install xclip       # For X11 sessions only

# Lazygit
sudo dnf copr enable atim/lazygit -y
sudo dnf install lazygit

# Yazi
sudo dnf copr enable varlad/yazi -y
sudo dnf install yazi

# Atuin
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

# Build tools
sudo dnf groupinstall "Development Tools"

# Fonts
sudo dnf install jetbrains-mono-fonts-all
# For Nerd Font icons, download from https://www.nerdfonts.com/font-downloads

Ubuntu/Debian

# Core tools (excluding Neovim - see below)
sudo apt install zsh tmux git stow

# Neovim 0.11+ (required for LSP config)
# The apt version is too old, install via AppImage:
curl -LO https://github.com/neovim/neovim/releases/download/v0.11.5/nvim-linux-x86_64.appimage
chmod u+x nvim-linux-x86_64.appimage
mkdir -p ~/.local/bin
mv nvim-linux-x86_64.appimage ~/.local/bin/nvim
# Add to PATH (add this to ~/.zshrc or ~/.bashrc):
# export PATH="$HOME/.local/bin:$PATH"

# pipx (required for Mason to install Python tools like isort, pylint)
sudo apt install pipx
pipx ensurepath

# Starship
curl -sS https://starship.rs/install.sh | sh

# Shell enhancements
sudo apt install fzf fd-find ripgrep bat eza tree xclip golang

# Zoxide
curl -sS https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | bash

# Eza
sudo apt install gpg
sudo mkdir -p /etc/apt/keyrings
wget -qO- https://raw.githubusercontent.com/eza-community/eza/main/deb.asc | sudo gpg --dearmor -o /etc/apt/keyrings/gierens.gpg
echo "deb [signed-by=/etc/apt/keyrings/gierens.gpg] http://deb.gierens.de stable main" | sudo tee /etc/apt/sources.list.d/gierens.list
sudo chmod 644 /etc/apt/keyrings/gierens.gpg /etc/apt/sources.list.d/gierens.list
sudo apt update && sudo apt install eza

# Lazygit
LAZYGIT_VERSION=$(curl -s "https://api.github.com/repos/jesseduffield/lazygit/releases/latest" | grep -Po '"tag_name": "v\K[^"]*')
curl -Lo lazygit.tar.gz "https://github.com/jesseduffield/lazygit/releases/latest/download/lazygit_${LAZYGIT_VERSION}_Linux_x86_64.tar.gz"
tar xf lazygit.tar.gz lazygit && sudo install lazygit /usr/local/bin && rm lazygit lazygit.tar.gz

# Yazi
cargo install --locked yazi-fm yazi-cli

# Atuin
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

# Build tools
sudo apt install build-essential

# Fonts
mkdir -p ~/.local/share/fonts && cd ~/.local/share/fonts
curl -fLo "JetBrainsMono Nerd Font.ttf" \
  https://github.com/ryanoasis/nerd-fonts/raw/HEAD/patched-fonts/JetBrainsMono/Ligatures/Regular/JetBrainsMonoNerdFont-Regular.ttf
fc-cache -fv

Note for Ubuntu/Debian: fd-find is installed as fdfind and bat as batcat. Create aliases:
mkdir -p ~/.local/bin
ln -s $(which fdfind) ~/.local/bin/fd
ln -s $(which batcat) ~/.local/bin/bat

Oh-My-Zsh + Plugins

# Install Oh-My-Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Install plugins (MUST be cloned to Oh-My-Zsh custom directory)
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

Important: Do NOT install zsh plugins via system package managers. They install to /usr/share/ which Oh-My-Zsh doesn't check.

Tmux Plugin Manager

git clone https://github.com/tmux-plugins/tpm ~/.config/tmux/.tmux/plugins/tpm

Development Tools (Optional)

# Node.js via NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc && nvm install node

# Deno
curl -fsSL https://deno.land/install.sh | sh

# Bun
curl -fsSL https://bun.sh/install | bash

# Formatters (after Node.js)
npm install -g @biomejs/biome prettier

# Stylua (Lua formatter) - if not installed via pacman
cargo install stylua

Installation

After installing all dependencies:

cd ~/dotfiles

# Stow all configurations
stow -t ~ */

# Or stow individually
stow -t ~ nvim tmux zsh starship kitty ghostty zed scripts

Post-Stow Setup

Set Zsh as default shell:
```
chsh -s $(which zsh)
```
Open Neovim - Lazy.nvim will auto-install plugins:
```
nvim
```

Start Tmux and install plugins:

tmux
# Press: Ctrl+a then Shift+I (capital i)
# Or run directly:
~/.config/tmux/.tmux/plugins/tpm/bin/install_plugins

Restart your terminal to apply all changes.

Scripts

Custom scripts are symlinked to ~/scripts/:

Script	Alias	Description
`fzf-git.sh`	`Ctrl+g`	Enhanced git operations with fzf
`tmux-sessionizer`	`tns`	Quick tmux session switching
`fzf_listoldfiles.sh`	`nlof`	Browse recent Neovim files
`zoxide_openfiles_nvim.sh`	`nzo`	Open files from zoxide history
`nvim-update`	-	Update Neovim AppImage to latest version

Customize tmux-sessionizer paths

Edit ~/scripts/tmux-sessionizer:

SEARCH_DIRS=(
    "$HOME/Documents/Projects"
    "$HOME/Desktop"
    "$HOME/dev"
    "$HOME/work"
)

Configuration Locations

After stowing, configs are symlinked to:

Config	Location
Neovim	`~/.config/nvim/`
Tmux	`~/.config/tmux/`
Starship	`~/.config/starship/`
Kitty	`~/.config/kitty/`
Ghostty	`~/.config/ghostty/`
Zed	`~/.config/zed/`
Zsh	`~/.zshrc`, `~/.zprofile`
Scripts	`~/scripts/`

Customization

Themes

Neovim: <leader>ths to open theme switcher
Tmux: Edit Catppuccin flavor in tmux/.config/tmux/tmux.conf
Starship: Modify palette in starship/.config/starship/starship.toml

Keybindings

Neovim: nvim/.config/nvim/lua/castro/core/keymaps.lua
Tmux: tmux/.config/tmux/tmux.conf
Zsh: zsh/.zshrc

Adding Neovim Plugins

Add plugin files to nvim/.config/nvim/lua/castro/plugins/ - Lazy.nvim auto-loads them.

Troubleshooting

Zsh: Plugin not found

[oh-my-zsh] plugin 'zsh-autosuggestions' not found

Plugins must be cloned to ~/.oh-my-zsh/custom/plugins/. See Oh-My-Zsh + Plugins.

Zsh: Command not found

Ensure all tools are installed and paths are set. Run source ~/.zshrc after changes.

Neovim: Plugins not loading

rm ~/.config/nvim/lazy-lock.json
nvim

Neovim: LSP not working

:Mason      " Check installations
:LspInfo    " Check LSP status

Neovim: nvim-lspconfig deprecation warning

nvim-lspconfig support for Nvim 0.10 or older is deprecated

The LSP config uses Neovim 0.11+ APIs (vim.lsp.config, vim.lsp.enable). Install Neovim 0.11+ via AppImage - see Ubuntu/Debian instructions.

Mason: Python tools fail to install (isort, pylint)

On Debian/Ubuntu, pip cannot install packages globally (PEP 668). Install pipx:

sudo apt install pipx
pipx ensurepath

Restart your terminal and reopen Neovim.

Tmux: Plugins not loading

rm -rf ~/.config/tmux/.tmux/plugins/tpm
git clone https://github.com/tmux-plugins/tpm ~/.config/tmux/.tmux/plugins/tpm
# Restart tmux, press Ctrl+b then I

Icons not displaying

Install a Nerd Font and configure your terminal to use it.

Credits

folke - lazy.nvim and Neovim plugins
junegunn - fzf and fzf-git.sh
ThePrimeagen - tmux-sessionizer inspiration

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 16 Commits
ghostty/.config/ghostty		ghostty/.config/ghostty
kitty/.config/kitty		kitty/.config/kitty
nvim/.config/nvim		nvim/.config/nvim
scripts/scripts		scripts/scripts
starship/.config/starship		starship/.config/starship
tmux/.config/tmux		tmux/.config/tmux
zed/.config/zed		zed/.config/zed
zsh		zsh
.gitignore		.gitignore
.stow-local-ignore		.stow-local-ignore
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

Dotfiles

Quick Start

What's Included

Dependencies

Arch Linux

Fedora

Ubuntu/Debian

Oh-My-Zsh + Plugins

Tmux Plugin Manager

Development Tools (Optional)

Installation

Post-Stow Setup

Scripts

Customize tmux-sessionizer paths

Configuration Locations

Customization

Themes

Keybindings

Adding Neovim Plugins

Troubleshooting

Zsh: Plugin not found

Zsh: Command not found

Neovim: Plugins not loading

Neovim: LSP not working

Neovim: nvim-lspconfig deprecation warning

Mason: Python tools fail to install (isort, pylint)

Tmux: Plugins not loading

Icons not displaying

Credits

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages