Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/milanaryal/config
Personal checklist for setting up a new Mac's dev environment.
https://github.com/milanaryal/config
checklist config development-environment mac macos shell
Last synced: about 1 month ago
JSON representation
Personal checklist for setting up a new Mac's dev environment.
- Host: GitHub
- URL: https://github.com/milanaryal/config
- Owner: milanaryal
- License: mit
- Created: 2015-11-13T17:20:06.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2024-02-19T15:44:23.000Z (7 months ago)
- Last Synced: 2024-04-10T17:44:19.342Z (6 months ago)
- Topics: checklist, config, development-environment, mac, macos, shell
- Homepage:
- Size: 2.3 MB
- Stars: 7
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - milanaryal/config - Personal checklist for setting up a new Mac's dev environment. (Others)
README
# Config
Config is a basic checklist I follow to set up a new Mac's development environment. It gets me up to speed with Git, Ruby, Node.js, GitHub, Jekyll, Hugo, and more so I can more quickly get back to coding.
## Checkout
- [Terminal](https://support.apple.com/guide/terminal/welcome/mac)
- [Xcode Command Line Tools](https://developer.apple.com/xcode/resources/)
- [Visual Studio Code](https://code.visualstudio.com/),
view source on [Github](https://github.com/Microsoft/vscode).
Essential extension for VS Code: [EditorConfig](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)
- [GitHub Desktop](https://desktop.github.com/),
view source on [Github](https://github.com/desktop/desktop#readme)
Or, use [GitHub CLI](https://cli.github.com/manual/gh),
view source on [Github](https://github.com/cli/cli#readme)
- Setup GitHub Desktop/CLI cloning path: `\home\milan\github`
(i.e. `\home\\github`)
## Setup VS Code
- Follow the installation process from [official docs](https://code.visualstudio.com/docs/setup/mac#_installation).
- [Launching from the command line](https://code.visualstudio.com/docs/setup/mac#_launching-from-the-command-line) — you can also run VS Code from the terminal by typing 'code' after adding it to the path:
i. Launch VS Code.
ii. Open the Command Palette `Cmd+Shift+P` and type `shell command` to find the "Shell Command: Install 'code' command in PATH command".
iii. Restart the terminal for the new `$PATH` value to take effect. You'll be able to type `code .` in any folder to start editing files in that folder.
## Setup Homebrew
- Open Terminal app and run following commang to install [Homebrew](https://brew.sh/) in your system:
```zsh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
- Run these three commands in your terminal to add Homebrew to your PATH:
```zsh
# ~/.zprofile <-> /users/milan/.zprofile
echo '# Set PATH, MANPATH, etc., for Homebrew.' >> /users/milan/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /users/milan/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
```
Once Homebrew has installed, you may want to [opt out of the Homebrew analytics data sharing](https://docs.brew.sh/Analytics), which is enabled by default. To turn this off, you can set this variable in your environment:
```zsh
export HOMEBREW_NO_ANALYTICS=1
```
Alternatively, this will prevent analytics from ever being sent:
```zsh
brew analytics off
```
- Run `brew` help to get started
- Further documentation:
_Homebrew auto install and setup xCode Command Line Tools. For manual installation open Terminal and trigger Xcode Command Line Tools installation: `xcode-select --install`._
If to uninstall Homebrew, [read here](https://github.com/homebrew/install#uninstall-homebrew). - Homebrew [FAQ](https://docs.brew.sh/FAQ#how-do-i-uninstall-homebrew), [Superuser](https://superuser.com/questions/203707/how-to-uninstall-homebrew)
## Setup Ruby
- Install [rbenv](https://github.com/rbenv/rbenv) via Homebrew:
```zsh
brew install rbenv ruby-build
```
- Set up rbenv in your shell. Run `rbenv init` and follow the printed instructions:
```zsh
echo '# rbenv' >> ~/.zprofile
echo 'eval "$(rbenv init -)"' >> ~/.zprofile
```
- Verify rbenv is configured properly:
```zsh
type rbenv
```
- Verify that rbenv is properly set up using _rbenv-doctor_ script:
```zsh
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-doctor | bash
```
- Download a version of Ruby via rbenv: See .
```zsh
# Download a version of Ruby via rbenv:
$ rbenv install 3.2.3
# Make it the global version of Ruby:
$ rbenv global 3.2.3
# Additional dependencies:
$ gem install bundler
```
- Ruby setup guide [by Jekyll](https://jekyllrb.com/docs/installation/macos/).
_Installing and managing Ruby with rbenv allows us to specify versions of Ruby on a per-project basis. It also means we can avoid running sudo commands for installing gems and more as it's not affecting OS's system Ruby._
_Having trouble with nokogiri? See ._
## Setup Node.js
- Install [nodenv](https://github.com/nodenv/nodenv) via Homebrew:
```zsh
brew install nodenv
```
- Set up nodenv in your shell. Run `nodenv init`:
```zsh
echo '# nodenv' >> ~/.zprofile
echo 'eval "$(nodenv init -)"' >> ~/.zprofile
```
- Verify nodenv is configured properly:
```zsh
type nodenv
```
- Verify that nodenv is properly set up using _nodenv-doctor_ script:
```zsh
curl -fsSL https://github.com/nodenv/nodenv-installer/raw/master/bin/nodenv-doctor | bash
```
- Download a version of Node.js via nodenv:
```zsh
# Download a version of Node.js via nodenv:
$ nodenv install 20.11.1
# Make it the global version of Node.js:
$ nodenv global 20.11.1
# https://www.npmjs.com/package/npm-check-updates
$ npm install -g npm-check-updates
```
Learn more:
- [installing-node-versions](https://github.com/nodenv/nodenv#installing-node-versions)
- [uninstalling-node-versions](https://github.com/nodenv/nodenv#uninstalling-node-versions)
- [uninstalling-nodenv](https://github.com/nodenv/nodenv#uninstalling-nodenv)
- bin/{[node-build](https://github.com/nodenv/node-build/blob/master/bin/node-build),[nodenv-install](https://github.com/nodenv/node-build/blob/master/bin/nodenv-install),[nodenv-uninstall](https://github.com/nodenv/node-build/blob/master/bin/nodenv-uninstall)}
_Installing and managing Node.js with nodenv allows us to specify versions of Node on a per-project basis. It also means we can avoid running sudo commands for installing global packages and more as it's not affecting OS's system Node.js._
## Setup Git
> Please tell me who you are.
- Run to set your account's default identity:
```zsh
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
```
_Omit `--global` to set the identity only in this repository. For privacy purpose use GitHub private email address `[email protected]` for git config._
## Setup GitHub CLI
- [Installation](https://github.com/cli/cli#installation)
```zsh
brew install gh
```
- [gh auth](https://cli.github.com/manual/gh_auth)
```zsh
gh auth login
```
- Follow output of [GitHub CLI](https://cli.github.com/)
_[See output](gh-auth.md)._
- [gh repo clone](https://cli.github.com/manual/gh_gist_clone)
```zsh
gh repo clone milanaryal/config
```
- [gh repo sync](https://cli.github.com/manual/gh_repo_sync)
```zsh
cd milanaryal/config
gh repo sync
```
### Firefox Configuration Setup
- [Best Privacy Web Browser to Stay Private](https://www.privacytools.io/private-browser) by Privacy Tools
- [Firefox Recommended Configuration](https://www.privacyguides.org/en/desktop-browsers/#firefox) by Privacy Guides
- [Firefox Hardening Resources](https://chrisx.xyz/blog/yet-another-firefox-hardening-guide/)
- [The Ultimate Guide to Firefox Hardening!](https://www.youtube.com/watch?v=F7-bW2y6lcI)
- `about:config` -> `fission.autostart` = `true`
- `about:config` -> `extensions.pocket.enabled` = `false`
### Invitation
Sign-up with the following invitation link to get extra 500 MB bonus cloud space:
- [Dropbox](https://www.dropbox.com/referrals/AADapKnBJpLqYvSvMcBxGAk9N4iiYHh7hJI?src=global9)
- [OneDrive](https://onedrive.live.com?invref=8276ca569c4bc513&invscr=90)
**Brother's ([@kshitizaryal](https://github.com/kshitizaryal)):**
- [OneDrive](https://onedrive.live.com/?invref=f7e00c70d669a457&invscr=90)