# setting up zsh

## install HomeBrew for Mac

go to <https://brew.sh>

**Note: Be sure to run the commands which brew tells you to run at the end of your brew install!**

## install and setup zsh

    echo $SHELL
    
if this is zsh go to the next stage, if not check zsh is installed

    which zsh
    
### if zsh **is found** 

go to install oh-my-zsh

### if zsh is **not found**, install with brew following the steps below

    brew install zsh
    
to set zsh as your shell use chsh
    
    chsh -s `which zsh`

close and reopen the terminal

## install and setup oh-my-zsh

    sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"

## install nerd fonts

I use the example of Meslo Nerd Font, feel free to install one you prefer. 

Examples can be found here https://www.nerdfonts.com/font-downloads

    brew search nerd-font 
    # select your fond from that list and install
    brew install --cask font-meslo-lg-nerd-font

**Note: You may need to restart your mac for these fonts to show up**

**WARNING: In your Mac Terminal app, make sure you use a nerd font as your font of choice before you continue**


## install PowerLevel10k

https://github.com/romkatv/powerlevel10k#oh-my-zsh

    git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
    
Now, edit the ZSH_THEME in ~/.zshrc file into :

```shell
ZSH_THEME="powerlevel10k/powerlevel10k"
```

then run

    source ~/.zshrc

if for some reason you need to re-run your config, you can use this command.

    p10k configure
    
## additional zsh tools

Download zsh-autosuggestions :

    git clone https://github.com/zsh-users/zsh-autosuggestions.git $ZSH_CUSTOM/plugins/zsh-autosuggestions 

Download zsh-syntax-higlighting :

    git clone https://github.com/zsh-users/zsh-syntax-highlighting.git $ZSH_CUSTOM/plugins/zsh-syntax-highlighting

Edit `~/.zshrc` file, find plugins=(git) replace plugins=(git) with :

```shell
plugins=(
  # autoswitch_virtualenv
  aws
  git
  zsh-autosuggestions 
  zsh-syntax-highlighting
  )
```

Reopen your terminal, now you should be able to use the auto suggestions and syntax highlighting.