This is a collection of scripts to setup your macOS.
They are designed for the neue fische web development course.
You should have the latest macOS installed. To make sure, click on the apple logo at the top left, go to "About this Mac" and click "Software Update". Install any missing updates.
Find and run the program "Terminal". This is a program that allows you to run commands on your computer. You can press ⌘Space to open Spotlight. Type in the program's name and press Enter.
Copy the command you want to run and paste it into the Terminal.
Run it by pressing Enter.
💡 In case of any errors, carefully read the error text and google for help. Ask a coach for help if you can't find a solution with your own research.
Begin with the 💻 General Setup. Continue with 🐙 Setting up git and GitHub, and finish with Setting up VS Code.
💡 You can check the "What does this do?" sections to learn what each script does in detail.
Installs desktop applications, command line tools and sets up the shell.
💡 Enter your macOS users password if you're asked for it and confirm with Enter. You won't see any characters while typing, but it's still working.
If you are asked to enable fuzzy auto-completion, enable key bindings and update shell configuration files confirm by pressing Enter.
zsh <(curl -s https://raw.githubusercontent.com/neuefische/web-setup/main/setup)What does this do?
This command will download the setup script from GitHub and run it on your computer.
The script will install Homebrew which is a package manager for macOS.
Using Homebrew it will install the following command line tools:
- gh is a command line tool for GitHub
- git is a version control system
- antigen is a plugin manager for zsh (the shell)
- zsh-completions is a collection of additional auto completion definitions for zsh
- exa is a modern replacement for ls (list files)
- tree is a recursive directory listing command that produces a depth indented listing of files
- fnm is a fast and simple Node.js version manager
It will also install the following desktop applications using Homebrew:
- iTerm2 is a terminal emulator for macOS
- Visual Studio Code is a code editor
- Rectangle is a window manager for macOS
- QuickLook JSON is a quicklook plugin for JSON files
- Firefox Developer Edition is a web browser
Using fnm the script will install the latest LTS version of Node.js a JavaScript runtime.
The script will use npm to install the following packages globally:
- eslint is a tool for identifying and reporting on patterns found in ECMAScript/JavaScript code
The script will copy zsh configuration files from this repository to configure zsh. It will also setup shell-integration for iTerm.
Sets up git and connects it to GitHub.
💡 Please enter your name and email address and confirm each with Enter.
Confirm the defaults by pressing Enter when asked about which file to save key and your passphrase.
Choose
sshas your preferred connection method. Login and authenticate to GitHub using the browser. (The device code is found in the Terminal.)
zsh <(curl -s https://raw.githubusercontent.com/neuefische/web-setup/main/setup-git)What does this do?
This command will download the setup-git script from GitHub and run it on your computer.
The script will setup git and create a new ssh key for GitHub. It will also add the key to your GitHub account using the GitHub CLI.
We use the comand line tool ghcd for downloading the challenges. On site cohorts need to set it up with the instructions below. For remote cohorts it should work out of the box, but if you run into issues follow these instructions.
Follow these instructions to prepare VS Code for our bootcamp.
A video showing the setup process can be found on YouTube:
