_ _ _
| | | | | |
| |___| |_____ __| | ____ Yet Another Dotfile Repo
|_____ (____ |/ _ |/ ___)
_____| / ___ ( (_| | | @lfilho's Version
(_______\_____|\____|_|
sh -c "`curl -fsSL https://raw.githubusercontent.com/lfilho/dotfiles/main/install.sh`"
Table of Contents:
- Installation
- Upgrading
- What is YADR?
- What is (this fork's version of) YADR?
- What's included, how to learn, how to customize?
- Docker Support
- Testing
- Screenshot
- Vimization of everything
- OSX
- Credits
To get started please run:
sh -c "`curl -fsSL https://raw.githubusercontent.com/lfilho/dotfiles/main/install.sh`"
Note: YADR will automatically install all of its subcomponents. If you want to be asked about each one, use:
sh -c "`curl -fsSL https://raw.githubusercontent.com/lfilho/dotfiles/main/install.sh`" -s ask
Please do help us improving Linux support in this repo ;-)
Linux installation is finnicky and might require running some of the commands from Rakefile
manually. PRs are welcome! :)
TIP: You can check the Dockerfile
to see what's need for a basic installation.
Remap caps-lock to esc!
The esc key is the single most used key in vim. Old keyboards used to have Esc where Tab is today. Apple keyboards are the worst with their tiny Esc keys. But all this is fixed by remapping Caps to Esc. If you're hitting a small target in the corner, you are slowing yourself down considerably, and probably damaging your hands with repetitive strain injuries.
For OSX: with Karabiner Elements (you can install it via brew)
For Ubuntu: dconf write /org/gnome/desktop/input-sources/xkb-options "['caps:swapescape']"
TODO / IDEA: Automate this step (saving Karabiner-Elements' .json and loading it after installing the app)
Upgrading is easy.
cd ~/.yadr
git pull --rebase
rake update
YADR is an opinionated dotfile repo that will make your heart sing
- The best bits of all the top dotfile repos, vim and zsh plugins curated in one place, into a simple and cohesive way of working.
- Several vim plugins, all under one roof, working together, each plugin researched and configured to be at its best, often with better shortcut keys.
- Many zsh plugins, starting with the wonderful Prezto base, and adding a few niceties on top.
- All things are vimized: command line, irb, postgres command line, tmux, etc.
This is @lfilho's fork of the great work done by Yan (@skwp), Yadr.
I've been using Yadr since 2013 but since a couple of years ago my preferences and configurations started to diverge too much from upstream. So now my repo is barely mergeable with the original one. Although I'm still a contributor there, my main focus should on my fork (unless we converge again in the future of course :-)).
Here are the differences in a nutshell (also make sure you read the What's included, how to learn, how to customize? section):
- NeoVim in Terminal rather than GUI MacVim
- Generally faster vim experience (mostly because of RipGrep and NeoVim's async stuff, but we also use less plugins)
- Keymaps that don't rely on MacOS's Cmd key, so keymaps would stay cohesive in both TUI vim, GUI vim and Linux environments.
- Testing. We have basic CI testing. See more about it in the Testing section.
- Different set of VIM plugins. That's too big of a list to keep up to date here in README so if you're interested you're better off comparing the two repo's plugins. What I can say is:
- We focus less on Ruby, since it's not my most used language
- We focus a little more on Javascript/Node
- We focus on plugins that work better with NeoVim's better features and architecture
- Couple of new aliases for command line and also git
- Different file and folder organization and conventions for vim plugins and configurations (all contained to installation folder)
- Automated iTerm2 configuration (including themes and colors)
- Brew packages. I have added a
Brewfile
which makes easier to mantain and more flexible for the community to customize (you can pointbrew
to different Brewfiles whenever you need; also easier to customize in your own fork) - Docker. Means you can test this repo in a Docker container without messing with your host environment until you're sure. More on that in the Docker Support section below.
- Linux support. It's still very far from ideal, but it's my intention to leave the repo working for both MacOS and Linux as well as we can. The initial effort is done via the Docker support. The community can take it from there and help improve things.
- Themes and colors. I'm not a fan of Solarized so I removed it and so far I'm enjoying Gruvbox theme (both for Vim and the terminal). I have also created my own zsh prompt. There are some screenshots in the Screenshots section below.
The best way to learn the answer the the above questions is to browse the README files in each directory (starting with this one). For example, if you're insterested in seeing which vim plugins are there, as well their keymaps, head to nvim/README.md and start from there, proceeding to its subfolders' README and finally to each configuration file (there will be more specific comments inside each file).
We can use Docker to test some changes in a Linux Container.
Assuming your host system has Docker & Docker Compose properly installed, run:
docker-compose run dotfiles
This will build the container image it never built it before (which may take a while -- future times will be faster) and then run a zsh
session inside that container for you.
There you can play around, test commands, aliases, etc.
Warning: this repo is primarly OSX oriented. So any support for Linux can only be done with the help of the community.
We have a basic automated CI testing for both Linux and OSX. Head to test/README.md for more details.
Here's how my zsh prompt looks like on iTerm:
And here's another example inside a tmux's pane with tmux's statusline (powerline style):
It's using Gruvbox colors. For screenshots on how Vim looks with Gruvbox, you can check their gallery out.
The provided inputrc and editrc will turn your various command line tools like mysql and irb into vim prompts. There's also an included Ctrl-R reverse history search feature in editrc, very useful in irb, postgres command line, and etc.
See Other recommended OSX productivity tools.
Also, the a osx file is a bash script that sets up sensible defaults for devs and power users under osx. Read through it before running it. To use:
bin/osx
These hacks are Lion-centric. May not work for other OS'es. My favorite mods include:
- Ultra fast key repeat rate (now you can scroll super quick using j/k)
- No disk image verification (downloaded files open quicker)
- Display the
~/Library
folder in finder (hidden in Lion)
See Credits & Thanks