mirror of
https://github.com/anthonyoteri/dotfiles.git
synced 2026-06-05 15:46:54 -04:00
Anthony Oteri
76 lines
2.4 KiB
Markdown
76 lines
2.4 KiB
Markdown
|
||
|
||
# dotfiles
|
||
|
||
Personal dotfiles managed by Gnu Stow for a modular, reproducible, and portable
|
||
development environment.
|
||
|
||
## Usage
|
||
|
||
Clone this repository to `~/dotfiles`:
|
||
|
||
```sh
|
||
git clone https://github.com/anthonyoteri/dotfiles ~/dotfiles
|
||
```
|
||
|
||
Change into the `~/dotfiles` directory and create the symlink tree:
|
||
|
||
```sh
|
||
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](LICENSE) for details.
|
||
|