GitHub - faruzzy/dotfiles: My dotfiles configuration for Linux / Mac OS X

These are my personal dotfiles for macOS. They configure my development environment to my liking, with a focus on efficiency and a pleasant aesthetic.

Philosophy

The guiding principle that I follow when configuring my dotfiles is that things should be easy to do. So easy in fact that it should favor laziness. Everything here revolves around vim and its movement.

What's Inside?

This repository contains configurations for a variety of tools, including:

Terminal: Alacritty, Ghostty, tmux
Shell: Zsh (with Oh My Zsh), Starship prompt
Editor: Neovim
Git: git, git-delta, tig
Other Tools: fzf, bat, ripgrep, and many more.

Installation

The install.sh script automates the setup process. It is idempotent and Bash 3.2 compatible (works on a fresh macOS). It will:

Install Xcode Command Line Tools.
Install Homebrew and a wide range of packages.
Install several GUI applications.
Install programming languages like Python, Node.js, and Java (with Rosetta for Apple Silicon).
Set up Zsh with Oh My Zsh and plugins.
Configure Neovim (managed via bob) with a rich set of plugins.
Configure Starship prompt.
Create symbolic links for the dotfiles in this repository.
Apply macOS system preferences.

To start the installation, run the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/faruzzy/dotfiles/master/install.sh)"

Neovim Configuration

My Neovim setup is tailored for a modern development workflow, with a focus on providing a rich and efficient coding experience. It is built entirely in Lua and managed by lazy.nvim with ~94 plugins, all lazy-loaded for fast startup.

Structure

nvim/
├── init.lua                    # Entry point
├── lua/
│   ├── faruzzy/                # Core settings, keymaps, autocommands
│   ├── lsp/                    # LSP server definitions and attach hooks
│   ├── plugins/                # Plugin specs (~46 files)
│   ├── config/                 # Theme and statusline components
│   └── utils.lua               # Helper functions
├── snippets/                   # Custom JS/TS/React/Rust snippets
└── after/queries/              # Treesitter query overrides

Theme

Catppuccin (mocha) with custom highlight overrides, rounded floating window borders, and full Nerd Font support.

LSP

Servers are managed by mason.nvim and configured via mason-lspconfig. The following servers are set up out of the box:

Server	Language
lua_ls	Lua
pyright	Python
rust_analyzer	Rust (via rustaceanvim)
typescript-tools	TypeScript / JavaScript
eslint	JS/TS linting
emmet_language_server	HTML/CSS abbreviations
tailwindcss	Tailwind CSS
html / cssls	HTML / CSS
jsonls	JSON (with schemas)
yamlls	YAML
clangd	C/C++
vimls	Vim script

Completion

Powered by blink.cmp, a Rust-based completion engine. Sources include LSP, snippets (LuaSnip), path, buffer, and lazydev. Completions are context-aware (e.g. buffer-only inside comments) and sorted by frecency.

Formatting

conform.nvim handles format-on-save with per-language formatters:

JS/TS/HTML/CSS/JSON: prettierd
Lua: stylua
Python: isort + black
Go: goimports + gofmt
Rust: rust-analyzer (built-in)
Shell: shfmt

Fuzzy Finding

fzf-lua is used for all fuzzy finding:

Binding	Action
`<C-p>`	Find files
`<M-f>`	Live grep
`<leader><CR>`	Open buffers
`<leader>/`	Buffer lines
`<leader>fw`	Grep word under cursor
`gd` / `gr` / `gi`	Go to definition / references / implementation

Git

gitsigns.nvim -- inline hunk indicators, stage/reset (<leader>hs/<leader>hr), blame (<leader>hb)
vim-fugitive -- full Git command suite (g<CR> for status, <leader>gd for diff)
diffview.nvim -- visual diff browser

Language-Specific Tooling

TypeScript / JavaScript

typescript-tools.nvim with inlay hints, auto JSX closing, and import management (<leader>io organize, <leader>ia add missing, <leader>ir remove unused)
Custom React hook snippets (us useState, ue useEffect, ur useRef, um useMemo, uc useCallback, and more)
Programmatic React component snippet with auto prop destructuring

Rust

rustaceanvim with hover actions, runnables (gBr), debuggables (gBR), macro expansion (gBe), and external docs (gK)
Custom Rust snippets (structs, enums, traits, impls, tests, error handling, and more)

Key Bindings

Leader key is , (comma). A few highlights:

General

Binding	Action
`<Tab>`	Switch to last buffer
`<C-c>`	Toggle file explorer (neo-tree)
`<leader>rn`	Rename symbol
`<leader>ca`	Code action
`<leader>e`	Diagnostic float
`]d` / `[d`	Next / previous diagnostic
`<leader>ti`	Toggle inlay hints
`<leader>tc`	Toggle conceal
`<leader>ut`	Undo tree
`<leader>as`	Toggle auto-save
`<leader>1`-`5`	Jump to buffer 1-5
`<A-j>` / `<A-k>`	Move line(s) up / down
`<leader>c`	Compile and run (C, Java, JS, Python, sh)
`<CR>`	Re-run last ex command

Buffers & Windows

Binding	Action
`]b` / `[b`	Next / previous buffer
`<leader>aq`	Close all other buffers
`<leader>o`	Close all other windows
`<leader>x`	Save and close buffer
`<leader>X`	Save all and quit

Fuzzy Finding (fzf-lua)

Binding	Action
`<C-p>`	Find files
`<M-f>`	Live grep project
`<leader><CR>`	Open buffers
`<leader>/`	Search current buffer lines
`<leader>fw` / `<leader>fW`	Grep word under cursor (project / buffer)
`<C-g>`	Resume last fzf picker
`<leader>of`	Recently opened files
`gd` / `gr` / `gi`	Go to definition / references / implementation
`D`	Go to type definition
`<leader>ds` / `<leader>ws`	Document / workspace symbols
`<leader>dw`	Workspace diagnostics
`<leader>k`	Keymaps
`<leader>m`	Marks
`<leader>"`	Registers
`<leader>sh`	Help tags

Git (fzf-lua + gitsigns + fugitive)

Binding	Action
`<leader>gx` / `<leader>gX`	Git commits / buffer commits
`<leader>gS`	Git status
`<leader>gB`	Git branches
`<leader>hs` / `<leader>hr`	Stage / reset hunk
`<leader>hS` / `<leader>hR`	Stage / reset entire buffer
`<leader>hp`	Preview hunk
`<leader>hb`	Blame line
`<leader>tb`	Toggle inline blame
`<leader>tg`	Toggle show deleted
`]c` / `[c`	Next / previous hunk
`<leader>pr`	Open GitHub PR for current branch

Clipboard

Binding	Action
`<leader>yfn`	Copy filename
`<leader>yp` / `<leader>yap`	Copy relative / absolute path
`<leader>yfp` / `<leader>yafp`	Copy relative / absolute filepath

Search

Binding	Action
`<leader>?`	Google search word under cursor
`<leader>!`	Google "I'm Feeling Lucky"

Use which-key.nvim to discover all available bindings -- just press <leader> and wait.

UI

bufferline.nvim -- tabline with buffer grouping by language and type
lualine.nvim -- statusline showing mode, git branch, diagnostics, LSP status, and tmux zoom indicator
incline.nvim -- floating filename labels on splits
indent-blankline.nvim -- indent guides
alpha.nvim -- startup dashboard
trouble.nvim -- diagnostics panel (<leader>tt)

Notable Extras

NVM auto-detection -- reads .nvmrc / .node-version to use the correct Node version inside Neovim
Code action lightbulb -- shows a hint when code actions are available
Treesitter -- 40+ parsers with text objects (af/if for functions, ac/ic for classes), auto-tag closing, and sticky context
vim-tmux-navigator -- seamless <C-h/j/k/l> navigation between Neovim splits and tmux panes
gx.nvim -- smart URL opening under cursor
in-and-out.nvim -- jump out of surrounding delimiters
early-retirement.nvim -- auto-close inactive buffers
nvim-lsp-file-operations -- LSP-aware file rename via neo-tree
auto-save -- saves on insert leave
persistent undo -- undo history survives across sessions
:JsConfig -- scaffolds a jsconfig.json at the nearest package.json root

Other Configurations

This repository also includes configuration files for:

Alacritty: A fast, cross-platform, OpenGL terminal emulator.
Ghostty: A fast, native terminal emulator.
tmux: A terminal multiplexer.
Zsh: A powerful shell with Oh My Zsh for plugin and theme management.
Starship: A minimal, blazing-fast cross-shell prompt.
bat: A cat(1) clone with syntax highlighting and Git integration.
skhd / yabai: Hotkey daemon and tiling window manager for macOS.
and more...

Credits

Shamelessly copied from various places.