dotfiles

Personal macOS dev environment — Neovim (LazyVim), zsh + Powerlevel10k, iTerm2 with JetBrainsMono Nerd Font, and a curated Homebrew bundle.

One-liner install

git clone https://github.com/paucolomesparta/dotfiles.git ~/dotfiles && ~/dotfiles/install.sh

The installer is idempotent — re-running it skips anything already in place.

What's included

Homebrew

Formulae: neovim, git, gh, fzf, ripgrep, bat, eza, fd, lazygit, jq, tmux, tree, htop, wget, shellcheck

Casks: iterm2, font-jetbrains-mono-nerd-font, font-meslo-lg-nerd-font

Neovim — LazyVim

Bootstraps lazy.nvim and pulls LazyVim plus the following extras:

• ai.claudecode
• coding.luasnip
• editor.neo-tree
• formatting.prettier
• lang.docker, lang.git, lang.java, lang.json, lang.kotlin, lang.markdown, lang.typescript
• linting.eslint
• vscode

Custom plugins:

• hardtime.nvim — hint when you keep mashing h/j/k/l
• which-key.nvim — discoverability for keymaps

Custom config under nvim/lua/config/:

• options.lua — relative numbers, scrolloff, 2-space indent, system clipboard, persistent undo
• keymaps.lua — save/quit, buffer nav, centred half-page scrolling, paste without yank
• autocmds.lua — yank highlight, trim trailing whitespace (skips markdown), treat *.gradle.kts as Kotlin

zsh

• oh-my-zsh with plugins: git, zsh-autosuggestions, zsh-syntax-highlighting, you-should-use, npm, node, brew, macos, fzf
• powerlevel10k theme (config in zsh/.p10k.zsh)
• NVM with .nvmrc auto-switching
• Quality-of-life aliases (ll, gs, gp, brewup, cat → bat, find → fd, grep → rg, …)

NVM

Installed via the official install script (v0.40.3). Node itself is not installed automatically — see manual steps.

iTerm2

Profile name Sparta, exported from the live setup. Uses JetBrainsMono Nerd Font and the current colour scheme.

Manual steps after install

1. Open iTerm2 → Preferences → Profiles and set Sparta as the default profile.
2. Install Node:

   nvm install --lts

3. (Optional) Re-tune the prompt:

   p10k configure

4. Reload the shell:

   exec zsh

Repo layout

dotfiles/
├── install.sh            # idempotent installer
├── Brewfile              # curated formulae + casks
├── nvim/                 # symlinked to ~/.config/nvim
│   ├── init.lua
│   ├── lazy-lock.json
│   ├── lazyvim.json
│   └── lua/
│       ├── config/       # options, keymaps, autocmds, lazy bootstrap
│       └── plugins/      # hardtime, which-key
├── zsh/
│   ├── .zshrc            # symlinked to ~/.zshrc
│   ├── .p10k.zsh         # symlinked to ~/.p10k.zsh
│   └── .zprofile         # symlinked to ~/.zprofile
├── iterm/
│   └── Sparta.json       # iTerm2 dynamic profile
└── README.md

Updating dotfiles

cd ~/dotfiles && git pull
# symlinks mean nvim config changes are live immediately
# for zsh changes: exec zsh

Notes

• install.sh backs up any pre-existing real files (e.g. ~/.zshrc) to <file>.backup-YYYYMMDD before linking.
• The script targets Apple Silicon (/opt/homebrew). It will warn on Intel Macs but will still attempt to continue.
• LSPs, language toolchains beyond Node, and cloud CLIs are intentionally not in the Brewfile — keep this repo lean and install those per-project.