🛠️ Dotfiles

Minimal, personal Neovim + terminal setup powered by lazy.nvim.
Fast, clean, and ready to go - with LSP 🧠, fuzzy find 🔍, formatting ✨, autocompletion 🚀, and beautiful themes 🎨.

I use Ghostty as my terminal - GPU-rendered, ligature support, and blazing fast.

---

✨ Features

• 🧩 Plugin Manager: lazy.nvim
• 🧠 LSP Support: nvim-lspconfig + mason.nvim
• ✨ Code Formatter: conform.nvim
• 🌳 Treesitter: nvim-treesitter
• 🚀 Completion: blink.cmp + snippets
• 📁 File Explorer: oil.nvim
• 🔍 Fuzzy Finder: fzf-lua
• 📊 Status Line: lualine.nvim
• 📐 Indent Detection: guess-indent.nvim
• 💬 Startup Goodies: snacks.nvim
• 📌 Navigation: harpoon
• ⚡ Motion & Navigation: flash.nvim
• 🎨 Themes: Rose Pine & Catppuccin

---

📦 Requirements

💡 This setup uses Homebrew to install dependencies.

If you don't have Homebrew installed, run the command below:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

🔗 Visit brew.sh to check for the latest installation command if the one above doesn't work.

Install the following tools using Homebrew:

brew install fzf tmux neovim git node rust python lazygit starship

• Homebrew (macOS)
• Neovim ≥ 0.10
• fzf
• Rust
• Node.js & npm
• Python 3
• git
• tmux
  ➕ Required for plugin support: TPM (Tmux Plugin Manager)
• A Nerd Font (JetBrainsMono, Hack, etc.)
• For enhanced z + cd experience: Zinit
• Recommended: Lazygit

---

🛠️ Setup Steps

⚙️ Setup

Make sure to back up your existing configs before proceeding.

1. Backup existing configs

[ -d ~/.config/nvim ] && mv ~/.config/nvim ~/.config/nvim.bak
[ -f ~/.zshrc ] && mv ~/.zshrc ~/.zshrc.bak
[ -f ~/.tmux.conf ] && mv ~/.tmux.conf ~/.tmux.conf.bak

2. Clone this repo

git clone https://github.com/johnpaulcas/dotfiles ~/.dotfiles

3. Create config folder

mkdir -p ~/.config

4. Symlink configs

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

# Tmux (optional)
ln -s ~/.dotfiles/.tmux.conf ~/.tmux.conf

# Zsh (optional)
ln -s ~/.dotfiles/.zshrc ~/.zshrc

⚠️ Make sure ~/.config/nvim does not already exist before symlinking.

5. Launch Neovim

nvim

Neovim will install all plugins via lazy.nvim on first launch.

---

Install tmux/tpm

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

After installation enter to tmux mode by running

tmux

Reload TMUX environment so TPM is sourced:

tmux source ~/.tmux.conf

Press prefix + I (capital i, as in Install) to fetch the plugin

---

🖋 Fonts

Use any Nerd Font for icon support in Neovim, Tmux, and Zsh:

• JetBrainsMono Nerd Font
• FiraCode Nerd Font
• Hack Nerd Font

---

💡 Tips

• :Lazy — open the plugin manager
• :Mason — manage LSP servers and tools
• :CheckHealth — check system dependencies
• <leader>ff — fuzzy file finder
• Customize themes in lazy.lua

---

Happy Hacking 💻✨