https://github.com/andrewmcodes-archive/mac-setup
https://github.com/andrewmcodes-archive/mac-setup
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/andrewmcodes-archive/mac-setup
- Owner: andrewmcodes-archive
- Created: 2018-11-15T00:53:43.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-11-15T01:08:31.000Z (over 6 years ago)
- Last Synced: 2025-01-01T06:22:24.312Z (5 months ago)
- Language: Shell
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Mac-setup
Mac-setup is a script to set up an macOS laptop for web and mobile development.
## Requirements
We support:
- macOS High Sierra (10.13)
- macOS Mojave (10.14)
## Install
Download the script:
```sh
curl --remote-name https://raw.githubusercontent.com/andrewmcodes/mac-setup/master/setup
```
Review the script (avoid running scripts you haven't read!):
```sh
less setup
```
Execute the downloaded script:
```sh
sh mac 2>&1 | tee ~/setup.log
```
Optionally, review the log:
```sh
less ~/setup.log
```
## Debugging
Your last mac-setup run will be saved to `~/setup.log`.
Read through it to see if you can debug the issue yourself.
If not, copy the lines where the script failed into a
[new GitHub Issue](https://github.com/andrewmcodes/mac-setup/new) for us.
Or, attach the whole log file as an attachment.
## What it sets up
macOS tools:
- [Homebrew] for managing operating system libraries.
[homebrew]: http://brew.sh/
Unix tools:
- [Exuberant Ctags] for indexing files for vim tab completion
- [Git] for version control
- [OpenSSL] for Transport Layer Security (TLS)
- [RCM] for managing company and personal dotfiles
- [The Silver Searcher] for finding things in files
- [Tmux] for saving project state and switching between projects
- [Watchman] for watching for filesystem events
- [Zsh] as your shell
[exuberant ctags]: http://ctags.sourceforge.net/
[git]: https://git-scm.com/
[openssl]: https://www.openssl.org/
[rcm]: https://github.com/thoughtbot/rcm
[the silver searcher]: https://github.com/ggreer/the_silver_searcher
[tmux]: http://tmux.github.io/
[watchman]: https://facebook.github.io/watchman/
[zsh]: http://www.zsh.org/
Heroku tools:
- [Heroku CLI] and [Parity] for interacting with the Heroku API
[heroku cli]: https://devcenter.heroku.com/articles/heroku-cli
[parity]: https://github.com/thoughtbot/parity
GitHub tools:
- [Hub] for interacting with the GitHub API
[hub]: http://hub.github.com/
Image tools:
- [ImageMagick] for cropping and resizing images
Testing tools:
- [Qt 5] for headless JavaScript testing via [Capybara Webkit]
[qt 5]: http://qt-project.org/
[capybara webkit]: https://github.com/thoughtbot/capybara-webkit
Programming languages, package managers, and configuration:
- [ASDF] for managing programming language versions
- [Bundler] for managing Ruby libraries
- [Node.js] and [NPM], for running apps and installing JavaScript packages
- [Ruby] stable for writing general-purpose code
- [Yarn] for managing JavaScript packages
[bundler]: http://bundler.io/
[imagemagick]: http://www.imagemagick.org/
[node.js]: http://nodejs.org/
[npm]: https://www.npmjs.org/
[asdf]: https://github.com/asdf-vm/asdf
[ruby]: https://www.ruby-lang.org/en/
[yarn]: https://yarnpkg.com/en/
Databases:
- [Postgres] for storing relational data
- [Redis] for storing key-value data
[postgres]: http://www.postgresql.org/
[redis]: http://redis.io/
It should take less than 15 minutes to install (depends on your machine).
## Customize in `~/.setup.local`
Your `~/.setup.local` is run at the end of the mac-setup script.
Put your customizations there.
For example:
```sh
#!/bin/sh
brew bundle --file=- <