Dotfiles

Modern, XDG-compliant, modular configuration for macOS (Apple Silicon) and Linux VMs. Built for speed, minimalism, and a "clean home" philosophy.

Architecture

Each tool is a GNU Stow package: <tool>/.config/<tool>/.... Running stow <tool> symlinks its contents into $HOME, keeping $HOME tidy and configs colocated under $XDG_CONFIG_HOME.

dotfiles/
├── home/.zshenv             # → ~/.zshenv
├── zsh/.config/zsh/         # → ~/.config/zsh/
├── nvim/.config/nvim/       # → ~/.config/nvim/
└── ...

Quick start

git clone --recursive https://github.com/Nishanth-Gobi/Dotfiles.git ~/dotfiles
cd ~/dotfiles
./install.sh

See Setup → macOS for details.

Module map

Module	Purpose
zsh	Shell, aliases, prompt, plugins
nvim	LazyVim-based editor config
git	Global git config, allowed signers
kitty	Terminal emulator
zed	Zed editor settings & keymaps
btop	System monitor
fastfetch	System info
lazygit	Git TUI
aws	AWS CLI config
aerospace	macOS tiling WM
assets	Wallpapers, terminal art