diff --git a/README.md b/README.md
index a9ac5f0..72fb0c0 100644
--- a/README.md
+++ b/README.md
@@ -1,33 +1,75 @@
+
+
 # dotfiles
-My Dotfiles managed by Gnu Stow
 
-## Usage:
+Personal dotfiles managed by Gnu Stow for a modular, reproducible, and portable
+development environment.
 
-Clone this repository to ~/dotfiles with the following command:
+## 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 using
+Change into the `~/dotfiles` directory and create the symlink tree:
 
 ```sh
 stow .
 ```
 
-## Adding a new file.
+## 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.
+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
+## 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.  E.g. `~/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`.
+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.