explaingit

skwp/dotfiles

6,973RubyAudience · developerComplexity · 2/5Setup · easy

TLDR

YADR is a pre-assembled set of configuration files for vim, zsh, and git on macOS, bundled with 90+ curated vim plugins and a polished Prezto shell, installed in one curl command.

Mindmap

mindmap
  root((repo))
    What it does
      Configure vim
      Configure zsh
      Configure git
    Tech stack
      90 vim plugins
      Prezto shell
      Ruby scripts
    Use cases
      Mac dev setup
      Terminal polish
      Faster editing
    Audience
      Mac developers
      Vim users
    Setup
      One curl command
      Easy upgrades
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Set up a fully configured vim and zsh development environment on macOS in minutes with a single install command.

USE CASE 2

Get 90+ curated vim plugins working together without spending time resolving conflicts or tuning defaults.

USE CASE 3

Add git shortcuts and a more readable log format to your daily terminal workflow instantly.

Tech stack

VimZshGitRubyPreztoiTerm

Getting it running

Difficulty · easy Time to first run · 5min

macOS only, iTerm is the assumed terminal, Caps Lock remap to Escape is recommended for comfortable vim use.

In plain English

YADR (Yet Another Dotfile Repo) is a curated collection of configuration files for vim, zsh, and git, aimed at developers who use a Mac and want a polished terminal and text-editor setup without spending weeks assembling it themselves. Dotfiles are the hidden configuration files on Unix-like systems that control how your tools behave, and this repo gives you a pre-assembled, opinionated set of them that all work together. The core of it is more than 90 vim plugins, selected and configured so they cooperate rather than conflict. On top of that, there is a zsh shell setup built on Prezto, which adds things like automatic spell correction for mistyped commands, fuzzy directory matching when you tab-complete, and a reverse history search. Git is also customized with shortcut commands and a more readable log format. Installation is a single curl command that runs an install script. The script pulls everything down and sets it up automatically. If you want to review each component before it installs, you can add a flag that asks for confirmation at each step. Upgrading later is also simple: pull the latest changes and run a single update command. YADR is built for macOS. Linux is not officially supported, though the authors note it may work. The README recommends a few additional tweaks after installation, such as remapping the Caps Lock key to Escape (useful for vim users who press Escape constantly) and picking the Solarized color theme inside iTerm, the terminal application the setup assumes you are using. The vim configuration is extensive enough that the repo provides separate documentation pages for navigation, text manipulation, code editing, and general utility plugins. The README includes a sampling of keyboard shortcuts to get you started, covering things like jumping between open files and moving by code structure rather than line by line.

Copy-paste prompts

Prompt 1
I just ran the YADR dotfiles install on my Mac. What are the most important vim keyboard shortcuts I should learn first for file navigation and switching between open buffers?
Prompt 2
Walk me through how to customize a specific vim plugin in a YADR dotfiles setup without losing my changes when I run the update command later.
Prompt 3
My terminal uses YADR with Prezto zsh. Show me how to use the fuzzy directory matching and reverse history search features in my shell.
Prompt 4
I installed YADR dotfiles and want to remap Caps Lock to Escape for vim on macOS. Give me the step-by-step system preference instructions.
Open on GitHub → Explain another repo

← skwp on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.