/dotfiles

This repo include shell scripts for executing the bulk of the configuration I follow to set up my Mac's development environment to get me up-to-speed with the tools et al. so I can more quickly get back to Chillin like Billin.

What's included:

File	Description
/terminals	Terminal.app themes (or profiles) I use.
install	Install cli tools, sdks, and apps I use.
update-os-settings	Configure macOS and the Terminal to be smarter.
/zshrc	Customizes Zsh and the prompt to be smarter.
/zshrc/.omz-yolo.zsh	Familiar environment variables, aliases, helper functions, et al.
/gh	GitHub CLI (or gh) configurations to specify shortcuts and helper functions.
/git/.gitconfig	Git CLI (or git) configurations to specify my name and email, shortcuts, colors, and more.
/git/.gitignore	Ignore macOS-specific and editor-specifics, taken from @github/gitignore.

Install

WARNING ‼️ Make sure you know what you are doing and use at your own risk!

1. First, run xcode-select --install to enable Command Line Tools.

2. Next, run softwareupdate --install-rosetta to enable Rosetta 2.

3. Download and install Homebrew and follow the post-installation instructions.

4. Next, clone this repo. ¹ Command Line Tools should install git, so we should be fine.

   mkdir Repos && \
   cd Repos && \
   git clone --recursive \
             --depth=1 \
             https://github.com/kosperera/dotfiles
             
   # Pull submodules.
   cd dotfiles && \
   git submodule update --recursive --remote

5. Then, run source ./update-os-settings to make macOS and Terminal.app to be smarter.

6. Next, run source ./install to install nerd fonts, dev tools, cli tools, sdks, apps and the like.

7. Import Terminal.app theme from /terminals folder, then change font to JetBrains Mono Nerd Font 12pt.

8. Restart the Terminal.app to install and setup cli tools. Some of these changes require a logout/restart to take effect.

9. Sign into VS Code and sync settings, profiles, extensions et al.

10. Sign into IntelliJ IDEA and sync settings, profiles, et al.

11. Sign into Docker Desktop and install Docker Extensions.

12. Sing into gh.

    gh auth login
    # Where do you use GitHub?? GitHub.com
    # What is your preferred protocol for Git operations on this host? HTTPS
    # Authenticate Git with your GitHub credentials? Yes
    # How would you like to authenticate GitHub CLI? Login with a web browser

13. Sign into aws.

    awsenv config
    # SSO session name (Recommended): Admin
    # Default client Region [None]: us-east-1
    # Profile name [AdministratorAccess-???]: Admin
    awsenv login Admin
    awsenv refresh Admin

14. Download Typora.app Tokyo Night theme from @Aemiii91/typora-theme-tokyo-night.

15. Download Microsoft 365 with OneDrive from Microsoft site, then sign into activate license.

Useful Commands / Aliases

• yolo is to update and upgrade Every Thuckin' Thing!
• dsprune is to clean up unused containers, images, and volumes.
• awsenv login <profile> to authenticate AWS.
• awsenv refresh <profile> to export AWS credentials and refresh tokens.
• serve <port> to spin up a dead simple HTTP server.

WOMM

Yep, it works on my machine and hopefully it does on your's as well but please don't hate me if it doesn't.

Credit

Many of the customizations are taken from:

• @elliottminns/dotfiles
• @kentcdodds/dotfiles
• @mathiasbynens/dotfiles, and
• @pawelgrzybek/dotfiles

License

Copyright (c)​ 2025 It's actually me (@kosperera). All rights reserved.

The source code is licensed under the MIT license.

Footnotes

1. How to update (or pull) submodules in a git repo? Answered by @ElectricRCAircraftGuy. See https://stackoverflow.com/a/74470585 (StackOverflow) ↩