2.4 KiB
dotfiles
Personal dotfiles managed by Gnu Stow for a modular, reproducible, and portable development environment.
Usage
Clone this repository to ~/dotfiles:
git clone https://github.com/anthonyoteri/dotfiles ~/dotfiles
Change into the ~/dotfiles directory and create the symlink tree:
stow .
Adding a New File
Move the file into the ~/dotfiles folder under the same directory structure as
if the root of the repository were the home folder, then run stow . to create a
symlink.
How It Works
The original files should live under the ~/dotfiles directory in the same layout
as they would appear in the home directory. Gnu Stow will walk the directory tree
and create symlinks in the parent directory of any files it finds there. For
example, ~/dotfiles/.foobar will be mapped as a symlink to ~/.foobar, and
~/dotfiles/some/path/.barfoo will be mapped as a symlink to
~/some/path/.barfoo.
Managed Configurations
This repository manages configuration for the following tools:
- Zsh (
.zshrc,.zprofile,.profile): Shell configuration, plugins, aliases, and environment variables. - Kitty (
.config/kitty/kitty.conf): GPU terminal emulator with Gruvbox dark theme, powerline separators, and font/padding customizations. - Tmux (
.config/tmux/tmux.conf): Terminal multiplexer with Gruvbox theme, vim-style navigation, mouse support, and plugin management via TPM. - Oh My Posh (
.config/ohmyposh/omp.toml): Prompt theme for Zsh, with multi-line, icons, language versions, and git status. - btop (
.config/btop/btop.conf): Resource monitor with Gruvbox theme, block graphs, mouse and vim key support, and matching font/padding. - Topgrade (
.config/topgrade.toml): Unified system upgrade tool, configured for notifications, cleanup, and parallel upgrades. - Neovim (
.config/nvim/): Editor configuration, plugins, and custom Lua scripts. - Zellij (
.config/zellij/config.kdl): Terminal workspace manager (if used).
Customization & Extensibility
- All configs are modular and can be extended by adding new files or folders and
running
stow .. - Each tool’s config is documented and tuned for performance, appearance, and seamless integration.
- Gruvbox dark theme is used for a consistent look across terminal, prompt, and resource monitor.
License
See LICENSE for details.