🛠️ My Dotfiles

Personal configuration files for a clean, consistent, and powerful development environment on macOS (or Linux).

Informations

• OS: macOS Sequoia
• Hardware: Apple M1 Pro
• Shell: fish
• Editor: neovim
• Terminal: kitty
• Browser: Safari, Firefox
• Launcher: Raycast
• Colorscheme: gruvbox (via kitty & neovim theme)

Structure

dotfiles/
├── .config/                # XDG-compliant application configs
│   ├── tmux/
│   ├── kitty/
│   └── ...
├── nvchad-config/          # Neovim config (as a Git submodule), resources: mgastonportillo
├── .gitmodules             # Submodule tracking file
├── .zshrc / .bashrc        # Shell configs
├── .gitconfig              # Git personal settings
└── README.md               # This file

Submodules

This repository uses Git submodules to manage large or external configs like Neovim.

• nvchad-config/ is a submodule pointing to nvchad-config

To clone the repo with submodules:

git clone --recurse-submodules https://github.com/tranlynhathao/dotfiles.git

If you’ve already cloned it:

git submodule update --init --recursive

How to Use

1. Create symlinks

You can link configs to the appropriate locations:

ln -s ~/dotfiles/.config ~/.config
ln -s ~/dotfiles/nvim ~/.config/nvim

Alternatively, you can use a dotfile manager like stow or home-manager.

2. Install dependencies

• Nerd Fonts: FiraCode Nerd Font, VictorMono Nerd Font
• Terminal emulator: Kitty
• Shell: Fish or Zsh
• Prompt: Starship

Tools & Technologies

• Neovim (with NvChad)
• tmux
• Kitty terminal
• Fish shell / Zsh
• Starship prompt

Philosophy

Each tool is modularized and easy to maintain. This setup aims to be fast, aesthetic, and minimal while remaining highly customizable.

Remove Submodule (if needed)

git submodule deinit -f nvim
git rm -f nvim
rm -rf .git/modules/nvim

Feedback & Issues

Feel free to fork, raise an issue, or reach out if you want to suggest improvements.

License

MIT License