This repository contains my personal configurations files. The main goal of this repository is for my own use. I like to keep my configuration consistent across my devices.
A lot of inspiration for these dotfiles, came from similar repositories. Hopefully they can also be of inspiration to you. Feel free to fork this repository and customize to your liking. If you have any suggestions or cool ideas, please let me know.
The general principle of these dotfiles is to keep it simple. I only add things I use and I understand. I opt for dependencies that do one thing very well rather than full blown solutions.
I have written an install script that does the following things automatically.
- Install Homebrew.
- Install some dependencies using
brew bundle. - Compile terminfo for tmux.
- Link the dotfiles in the correct place (backing up any configuration files already present).
- Telling iTerm2 to sync its preferences with the plist in this repository.
It shouldn't be too hard to customize this install script. I definitely recommend looking at the Brewfile to specify the dependencies that you want to install using Homebrew.
You run the install script by executing the following command.
./install.sh
In order to install the neovim plugins, run :PackerSync inside neovim.
The Brewfile lists the dependencies that I can't live without and that I want to have on all my devices. Running brew bundle installs these dependencies. I suggest you write your own Brewfile. You can find more information on the hombrew-bundle repository.
I use iTerm2 as my main terminal emulator on macos. I sync my preferences by using the built in iTerm2 feature to load its configuration from a custom folder. The install script specifies this folder in the iTerm2 preferences.
Vim and by extension neovim are amazing text editors. Once you get used to the vim-way of doing stuff, you never want to look back. I choose neovim over vim mostly for the builtin lsp support and because I want to support the project. They've done some amazing things with (neo)vim over the past few years.
I've migrated all my neovim configuration files to lua and use packer.nvim as my plugin manager. I only add plugins that I actually use. Many thanks for the amazing work that the developers of the following plugins did.
- windwp/nvim-autopairs
- lewis6991/gitsigns.nvim
- ellisonleao/gruvbox.nvim
- neovim/nvim-lspconfig
- nvim-lualine/lualine.nvim
- L3MON4D3/LuaSnip
- williamboman/mason.nvim
- williamboman/mason-lspconfig.nvim
- jose-elias-alvarez/null-ls.nvim
- hrsh7th/nvim-cmp
- wbthomason/packer.nvim
- nvim-telescope/telescope.nvim
- nvim-treesitter/nvim-treesitter
- christoomey/vim-tmux-navigator
I use tmux to easily manage and switch between multiple terminal windows. The key bindings of christoomey/vim-tmux-navigator also allow to easily switch between vim and terminal windows.
Even though I almost always use neovim instead of neovim, I've kept (a part) of my vimrc for cases where I don't have neovim at my disposal. However, since I don't spent much time in vim, I don't touch the configuration that often.
The shell that I use in my terminal is zsh. The most popular customization framework for zsh is definitely oh-my-zsh. The project is backed by an amazing community and I recommend it to everyone who wants cool customization without having to configure everything yourself. Since I like to keep things simple and I don't need all the features that oh-my-zsh adds, I don't use the framework but only use a few more minimal plugins. I simply install the following plugins using Homebrew.