An open API service indexing awesome lists of open source software.

https://github.com/sherpalabsio/.dotfiles

Tools and shortcuts for lazy developers
https://github.com/sherpalabsio/.dotfiles

dotfiles shell zsh zsh-configuration

Last synced: about 2 months ago
JSON representation

Tools and shortcuts for lazy developers

Awesome Lists containing this project

README

          

# Peter's Dotfiles

Tools and shortcuts I built for myself to automate manual work so I can focus on what matters.\
These also help me to reduce the mental load of remembering and typing out commands.\
No-one gets paid because they know by heart how to do connect to staging in a particular project.

## Highlights

All the .sh files are loaded recursively.\
The local folder keeps everything I want to keep private, like API keys, secrets, etc.

### Terminal command palette

- cmd + shift + p: Open the command palette
- It is a fuzzy search for commands I defined globally and for the current folder
- Select a command then hit cmd + enter to paste it to the prompt and execute it

### Shortcuts

```shell
# Open a Ruby, Rails, Elixir, or Phoenix console depending on the current folder
$ c

# Start docker, start the containers, offer an fzf list to select a container
# to connect to
$ con

# Git update - for feature branch workflow
# Update the current Git branch with changes from the upstream main branch
# It's best to work with the most recent version of the app

# Steps it follows:
# - Pulls the latest changes to my local main and feature branch
# - Deletes the merged branches
# - Runs an after hook if a folder specifies one
# (run bundle install, yarn install, migrate the DB, etc.)
$ gupd

# Git: Discard all changes
$ nah

# GitX: Open the current Git repository in SourceTree
# It works even if the Git folder is several levels up
$ gx

# Git amend: Add all changes to the last commit. Useful for TDD
$ gam

# Git rebase interactive all: Starts an interactive rebase for all the commits
# on the current branch
$ grbia

# Git undo: Removes the last commit without losing its changes
$ gu
```

### Terminal prompt (Zsh)

- When in a Git repository:
- Normal mode: `"{top-level-directory} {git-branch}"`
- For example: "project_awesome main"
- It also adds a ! after the branch name if there is any change
- Stopping at a commit: `"{top-level-directory} rebase-i > {target-sha} | {commit-subject}"`
- For example: "project_awesome rebase-i > 123456 | Fix Stripe webhook verification"
- This lets me know which commit is problematic in case of a rebase conflict or which commit we stopped at during an interactive rebase
- When not in a Git repository:
- `"{top-level-directory}"`

### SourceTree custom actions

#### Fixup commit for the selected commit

In SourceTree: Right click on a commit > Custom Actions > Fixup. It will create a fixup commit
for the selected commit using the files added to staging.

Create a new SourceTree custom action

- Menu caption: Fixup
- Script to run: ~/.dotfiles/git/sourcetree_custom_actions/create_fixup_commit.sh
- Parameters: $SHA

#### Amend all changes to the selected commit

In SourceTree: Right click on a commit > Custom Actions > Amend all. It will amend
all the changes to the selected commit.

SourceTree custom action settings:

- Menu caption: Amend all
- Script to run: ~/.dotfiles/git/sourcetree_custom_actions/amend_all.sh
- Parameters: $SHA

## Install

```shell
git clone git@github.com:nomadsherpa/dotfiles.git
mv ~/dotfiles ~/.dotfiles
# Homebrew https://brew.sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

## VS Code

### Sync config

```shell
ln -s ~/.dotfiles/vs_code/settings.json ~/Library/Application\ Support/Code/User/settings.json
ln -s ~/.dotfiles/vs_code/keybindings.json ~/Library/Application\ Support/Code/User/keybindings.json
ln -s ~/.dotfiles/vs_code/tasks.json ~/Library/Application\ Support/Code/User/tasks.json
ln -s ~/.dotfiles/vs_code/snippets/ ~/Library/Application\ Support/Code/User/snippets
```

### Make `code` command available in the terminal

Command Palette > shell command

## iTerm2

### Sync config

```shell
# Specify the preferences directory
defaults write com.googlecode.iterm2 PrefsCustomFolder -string "~/.dotfiles/iTerm/settings"

# Tell iTerm2 to use the custom preferences in the directory
defaults write com.googlecode.iterm2 LoadPrefsFromCustomFolder -bool true
```

### Turn off the login banner ("Last login ...")

```shell
touch ~/.hushlogin
```

## Oh My ZSH

### Install

https://ohmyz.sh/#install

### Sync config

```shell
mv ~/.zshrc ~/.zshrc.old
ln -s ~/.dotfiles/zsh/zshrc.symlink ~/.zshrc
```

### zsh-syntax-highlighting plugin

It has to be listed LAST in the plugins list in `~/.zshrc` for it to be enabled.

```shell
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
```

### Setup local secrets

```shell
touch $DOTFILES_PATH/local/localrc.sh
```

## Git

### Sync config

```shell
ln -s ~/.dotfiles/git/.gitconfig.global ~/.gitconfig
```

### Signing commits with GPG

```shell
brew install gpg
ln -s $DROPBOX_PATH/backup/.dotfiles/.gnupg ~/.gnupg
```

#### Sourcetree

```shell
ln `brew --prefix gpg`/bin/gpg `brew --prefix gpg`/bin/gpg2
```

Sourcetree > Preferences > Advanced > set custom path for GPG Program to `brew --prefix gpg`/bin/gpg

Sourcetree > Repo settings > Security > Enable GPG signing

Sourcetree > commit > Commit options > Sign commit

## asdf

### Install

```shell
brew install asdf
```

### Update

```shell
asdf plugin-update ruby
```

## Ruby

### Install

```shell
asdf plugin add ruby
asdf install ruby latest
asdf global ruby latest # set global ruby version
```

### Initial Set-up

```shell
ln -s ~/.dotfiles/ruby/irbrc.symlink ~/.irbrc
ln -s ~/.dotfiles/ruby/gemrc.symlink ~/.gemrc
```

### Install Rails and Bundler

```shell
gem install rails
gem install bundler
```

## Other tools

```shell
brew install fzf
$(brew --prefix)/opt/fzf/install # To install key bindings to iTerm and fuzzy completion

# Local Sherpa
git clone git@github.com:nomadsherpa/local_sherpa.git ~/.dotfiles/lib/local_sherpa
```

### VLC

```shell
mv -v ~/Library/Preferences/org.videolan.vlc/vlcrc ~/.dotfiles/others/vlc/vlcrc
ln -s ~/.dotfiles/others/vlc/vlcrc ~/Library/Preferences/org.videolan.vlc/vlcrc
```

## OSX Shortcuts

To check what we have:

```shell
defaults read -g NSUserKeyEquivalents
```

### Merge All Windows shortcut for all apps (cmd + shift + m)

```shell
defaults write -g NSUserKeyEquivalents -dict-add "Merge All Windows" -string '@$m'
```