{"id":19975424,"url":"https://github.com/briangershon/setup-mac","last_synced_at":"2026-04-11T07:04:23.183Z","repository":{"id":61083283,"uuid":"424315866","full_name":"briangershon/setup-mac","owner":"briangershon","description":"My personal configuration for MacOS machines.","archived":false,"fork":false,"pushed_at":"2023-01-14T21:36:39.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-01T18:46:49.914Z","etag":null,"topics":["bash","dotfiles","homebrew","macos","tmux-conf"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/briangershon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-03T17:15:33.000Z","updated_at":"2022-01-02T21:42:15.000Z","dependencies_parsed_at":"2023-02-09T20:31:16.014Z","dependency_job_id":null,"html_url":"https://github.com/briangershon/setup-mac","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/briangershon/setup-mac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briangershon%2Fsetup-mac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briangershon%2Fsetup-mac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briangershon%2Fsetup-mac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briangershon%2Fsetup-mac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/briangershon","download_url":"https://codeload.github.com/briangershon/setup-mac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briangershon%2Fsetup-mac/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31671630,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","dotfiles","homebrew","macos","tmux-conf"],"created_at":"2024-11-13T03:18:19.431Z","updated_at":"2026-04-11T07:04:23.137Z","avatar_url":"https://github.com/briangershon.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# setup-mac\n\nMy personal configuration for MacOS machines.\n\n## Setup MacOS Machine\n\nUpdate Computer name via `System Preferences \u003e Sharing`.\n\nInstall Desktop apps:\n\n- Install 1Password.\n- Install Brave Browser. Setup various profiles.\n- Dropbox\n- Discord\n\nIn Mac App Store, install:\n\n- Slack\n\n## Setup Developer Tools\n\nInstall iTerm2.\n\nInstall Docker Desktop.\n\n- for Apple Silicon (M1) machines you may need one of these when working with non-ARM containers:\n  - `export DOCKER_DEFAULT_PLATFORM=linux/amd64` to build containers on AMD/64 instead of default ARM/64.\n  - `softwareupdate --install-rosetta` to run Intel containers\n\nSwitch macOS shell to bash: Open Terminal and then run `chsh -s /bin/bash` then restart Terminal.\n\nInstall Microsoft Visual Code extensions:\n\n- `command-shift-p` and run `Shell Command: Install 'code' command in PATH`\n\n- `Prettier - Code formatter` by Prettier\n\n  - update Settings for `Editor: Default Formatter` to `Prettier - Code formatter`.\n\n- `Dev Containers` by Microsoft\n\n- `Solidity` by Nomic Foundation\n\n- `Tailwind CSS` by Tailwind Labs\n\n- `GitHub Codespaces` by GitHub\n\n- `Docker` by Microsoft\n\nSetup Passwordless Auth to Github via SSH\n\n    ssh-keygen -t ed25519 -C \"\u003cdesired email address here\u003e\"\n\n    # legacy version\n    ssh-keygen -t rsa -b 4096 -C \"\u003cdesired email address here\u003e\"\n\n    # add public key to Github\n\nFor nice visual Git diffs, there are many options:\n\n- Use VSCode's tools\n- Install `difftastic`, a Rust-based diff tool installed via Homebrew below. Run as `difft`.\n- Install Github Desktop and the command line tool so you can run `github .` in any repository.\n\nInstall Homebrew\n\n    xcode-select --install\n\n    /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)\"\n\nIf homebrew needs to be accessible for multiple user accounts on same machine: \u003chttps://medium.com/@leifhanack/homebrew-multi-user-setup-e10cb5849d59\u003e\n\nInstall apps via Homebrew:\n\n    brew install tmux git bash-completion gh difftastic gpg git-lfs yarn\n\nInstall `nvm` to install NodeJS:\n\n    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash\n\n... and install latest version:\n\n    nvm ls-remote\n    nvm install v18\n    nvm alias default v18\n\nInstall Go: https://github.com/briangershon/setup-go\n\n## Clone setup-mac and link up config files\n\nClone this repo locally via `git clone git@github.com:briangershon/setup-mac.git`\n\nSetup .dot config files\n\n    # if files already exist merge/remove before linking\n\n    cd ~\n    ln -s ~/setup-mac/dotfiles/.gitconfig\n    ln -s ~/setup-mac/dotfiles/.bash_profile\n    ln -s ~/setup-mac/dotfiles/.tmux.conf\n\n    rm ~/.profile\n\nAlso for `tmux` change MacOS keyboard shortcut so that CAPS LOCK maps to CTRL in \"System Preferences \u003e Keyboard\" then \"Modifier Keys...\" button. This gives you the very nice `CAPSLOCK-a` (already setup in `.tmux.conf` instead of default `CTRL-b`.\n\n## Additional Configuration\n\n### Git configuration\n\nImport your public/secret key for signing GitHub commits.\n\n```bash\ngpg --import ~/public-key.gpg\ngpg --allow-secret-key-import --import ~/secret-key.gpg\ngpg --list-keys\n```\n\nFor first-time setup, generate brand new keypair with `gpg`: https://gist.github.com/Beneboe/3183a8a9eb53439dbee07c90b344c77e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbriangershon%2Fsetup-mac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbriangershon%2Fsetup-mac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbriangershon%2Fsetup-mac/lists"}