{"id":19006898,"url":"https://github.com/yowainwright/macrustle","last_synced_at":"2025-04-22T19:24:34.806Z","repository":{"id":40299085,"uuid":"100840773","full_name":"yowainwright/macrustle","owner":"yowainwright","description":"Super basic setup instructions,  \"rustled up\" for coding on a Mac 💻💨","archived":false,"fork":false,"pushed_at":"2025-03-10T13:16:26.000Z","size":1299,"stargazers_count":4,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-17T11:59:17.027Z","etag":null,"topics":["bash","commandline","config","configuration","iterm","mac-os","mac-setup","zsh"],"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/yowainwright.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-08-20T05:32:44.000Z","updated_at":"2025-01-11T18:49:01.000Z","dependencies_parsed_at":"2024-12-22T08:34:39.186Z","dependency_job_id":"23b1b9ea-ebae-49b4-9c74-36a49137e8d7","html_url":"https://github.com/yowainwright/macrustle","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yowainwright%2Fmacrustle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yowainwright%2Fmacrustle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yowainwright%2Fmacrustle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yowainwright%2Fmacrustle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yowainwright","download_url":"https://codeload.github.com/yowainwright/macrustle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250307135,"owners_count":21409039,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","commandline","config","configuration","iterm","mac-os","mac-setup","zsh"],"created_at":"2024-11-08T18:34:59.964Z","updated_at":"2025-04-22T19:24:34.763Z","avatar_url":"https://github.com/yowainwright.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MacRustle 💻💨\n\n\u003e Setup instructions \"rustled up\" for coding on a Mac.\n\n---\n\n**Note:** this documentation has not been updated for the new **M1 Chip**. It will be updates soon (06.01.21).\n\nIt can take time to setup a new mac for development.\u003cbr /\u003e\nMacRustle provides super basic instructions to help with this process.\n\n---\n\n[Quick Setup](#quick-setup) | [General](#general-utility-notes) | [Standard Installations](#standard-development-package-installation-instructions) | [Iterm](#iterm) | [ZSH](#zsh) | [XCode](#install-xcode) | [Package Managers](#install-version-managers-and-package-managers) | [Homebrew](#homebrew) | [Node](#node) | [NVM](#nvm) | [Git](#setup-git) | [Cask](#cask) | [Mas](#mas)\n\n---\n\n## General Utility Notes\n\n- Generally written\n- Read before following/using instructions\n- File an [issue](/issues) if you have a problem or idea\n\n---\n\n**Note:** This document has repetitive links and content to ensure\u003cbr /\u003e\nthat steps are not missed and are considered appropriately.\n\n---\n\n## Standard development package installation instructions\n\nCommon development installations.\u003cbr /\u003e\nListed below are key steps for the setup process.\n\n---\n\n**Note:** Each step should be step you've done before. Not regularly, but before.\u003cbr /\u003e\nIf these steps feel very uncomfortable to you,\nthis list of instruction might not be yours to follow.\n\n---\n\n1. Download and install your preferred commandline tool.\n   - For this document, [Iterm](https://www.iterm2.com/) with [zsh](https://ohmyz.sh/) are used.\n1. Install [Homebrew](brew.sh)\n1. Install [Xcode](https://developer.apple.com/xcode/)\n1. Using Homebrew:\n   1. Install [Node](https://nodejs.org/en/about/)\n   2. Install [Git](https://git-scm.com/)\n\n---\n\n### Download a Commandline app\n\nDownload and setup your preferred commandline app.\u003cbr /\u003e\nFor this document, [Iterm](https://www.iterm2.com/downloads.html)\nwith [ZSH](https://ohmyz.sh/) is recommended.\n\n- [Iterm Downloads](ttps://www.iterm2.com/downloads.html)\n\n---\n\n#### Iterm\n\nDownload Iterm, a replacement commandline tool for Mac.\n\n##### ZSH\n\nA [Terminal Shell](http://ohmyz.sh/) with useful features and a powerful plugin ecosystem.\n\n**Note**: If you are running on MacOS Catalina (10.15.x), this step is done for you.\n`zsh` comes default with MacOS Catalina.\n\n```bash\n\nsh -c \"$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)\"\n\n```\n\n---\n\n##### Power tips ⚡️\n\nSetup [natural typing](https://apple.stackexchange.com/questions/154292/iterm-going-one-word-backwards-and-forwards#answer-293988)\n\n- Go to `preferences \u003e profiles \u003e keys`\n- Click `presets`\n- Select `natural typing`\n\nYou can now move your cursor like in all other apps! 💪\n\nSetup [autocomplete](https://github.com/zsh-users/zsh-autosuggestions)\n\n- `git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions`\n- add `zsh-autocompletion` to plugins within your `.zshrc` config\n\n\n### Install Xcode\n\n[Xcode](https://developer.apple.com/xcode/) is a tool for development on Mac OS.\n\n```bash\n\nxcode-select --install\n\n```\n\n### Install Version Managers and Package Managers\n\nInstall package managers. First [Homebrew](brew.sh).\n\n### Homebrew\n\nInstall Homebrew.\n\n```bash\n\n# homebrew\n/usr/bin/ruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\n\n```\n\n### Node\n\nUse Homebrew to install [Node](https://nodejs.org/en/).\n\n```bash\n\nbrew install Node\n\n```\n\n### NVM\n\nUse [NVM](https://github.com/nvm-sh/nvm) to manage Node version\nused within each environment.\n\n```bash\n\ncurl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash\n\n```\n\n### Setup Git\n\nGit can be setup in multiple ways.\u003cbr /\u003e\nOne way to setup Git is via Homebrew.\n\n```bash\n\nbrew install git\n\n```\n\n#### Setup Git Globals\n\nSetup standard git defaults\n\n```bash\n\n# all push/pull\ngit config --global push.default current\ngit config --global pull.default current\ngit config --global user.name \u003cuser_name\u003e\ngit config --global user.email \u003cuser_email\u003e\ngit config --global core.editor \u003ccode_editor\u003e\n\n```\n\nWhen working with a git client, like Github,\na [SSH Key](https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/)\nand associated email are needed.\n\n#### Setup a personal SSH Key\n\n```bash\n\nssh-keygen -t rsa -b 4096 -C \"your_email@example.com\"\n\n```\n\n### Other Brews to optionally install\n\nListed below are **highly recommended** Homebrew installs.\n\n#### Cask\n\n[Cask](https://github.com/Homebrew/homebrew-cask) installs Mac Apps via commandline.\n\n```bash\n\nbrew install cask\n\n```\n\n#### Mas\n\n[Mas](https://github.com/mas-cli/mas) installs Mac Store Apps via commandline.\n\n```bash\n\nbrew install mas\n\n```\n\n## Quick Setup\n\n1. Open ITerm (or another Shell).\n2. Copy and paste the following to your desired folder path `git clone git@github.com:yowainwright/macrustle.git`\n3. Navigate to the macrustle folder, in example, `cd macrustle`. Type `./bin/macrustle.sh`. Press **return**.\n4. Follow the prompts.💨\n5. **Quick setup** ends at installing `git`. To config git and an SSH Key, [start here](#setup-git-globals).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyowainwright%2Fmacrustle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyowainwright%2Fmacrustle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyowainwright%2Fmacrustle/lists"}