Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Juan's Dotfiles for MacOS

Screenshot of my shell prompt


Warning: If you want to give these dotfiles a try, you should first fork this repository, review the code, and remove things you don’t want or need. Don’t blindly use my settings unless you know what that entails. Use at your own risk!

  • I maintain this repo as my dotfiles.
  • You're quite welcome to make suggestions, however I may decline if it's not of personal value to me.


Using Git and the bootstrap script

To set this up, run the following command on your Home ($HOME) directory. This will clone the repository and start the bootstrap process to install everything.

git clone --depth=1 && cd dotfiles && bash

This will install everything related to the software described down below. If you are ok with that, after executing the command above, you can (hopefully) let it run and forget about everything else except the .gitconfig info described just below.

Also if you want to install Mac App Store software, remember that you have to be logged in to the App Store before running the script (that executes the script). And that software must have been downloaded manually at least once before, so it is registered on your Apple ID. This is a very specific case because, of course, the software that I use from the App Store is already registered in my account and I can automate this part.

These are caveats from the mas-cli. If you do not need software from the App Store or prefer to skip this part, comment out the bash ./ line from the file.

Git Config

This setup has, of course, my name and email that I use for my commits. If you are going to use this setup, remember to change this later with your information. I also use GPG to sign my commits, so change the signing key too!

Software Installers


The configuration I use for Vim. All these files are separate from this repository. You can take a look to the files in my vimrc repository.

If you want to install directly without using, you can use the following command:

git clone --depth=1 ~/.vim_runtime
sh ~/.vim_runtime/

This version includes a lot of great plugins, configurations and color schemes that make Vim a lot better, and you don't have to reinvent the wheel to get set up.


The file includes all the software that I'm currently using on my Mac that can be installed using the Homebrew Package Manager.

If you want to install this software directly without using, you can use the following command in your terminal:

bash ./


The file includes all the software related with Node and NPM.

If you want to install this software directly without using, you can use the following command in your terminal:

NOTE: You have to have NodeJS v14+ installed!!

bash ./


With the release of Spicetify v2, whatever I said about using the old Spotify UI with custom themes and color schemes have become obsolete.

So I decided to stop using Spotify. I will omit everything related to it and Spicetify, sorry! Going back to Apple Music.


The mas-cli is a really useful tool for installing apps from the Mac App Store. If you read the caveats from above, you can proceed installing the apps without using the script, using the following command in your terminal:

bash ./


When setting up a new Mac, you may want to set some sensible MacOS defaults. They are done with the script. If you want to execute it, you may need admin permission:

sudo bash ./

Oh My Zsh

Oh My Zsh is a delightful, open source, community-driven framework for managing a Zsh configuration. When executing it will run script, this will install:

You can install all this directly using the following command in your terminal:

bash ./

Special Thanks

This work would not exist if it wasn't from the awesome work of other developers from which I could read and learn from.