# macOS

## Requirements

  * macOS 10.8 or later
  * [Node.js](https://nodejs.org/en/download/) (0.10.x or above)
  * Command Line Tools for [Xcode](https://developer.apple.com/xcode/downloads/) (run `xcode-select --install` to install)

## Instructions

  ```sh
  git clone https://github.com/atom/atom.git
  cd atom
  script/build # Creates application at /Applications/Atom.app
  ```

### `script/build` Options
  * `--install-dir` - The full path to the final built application (must include `.app` in the path), e.g. `script/build --install-dir /Users/username/full/path/to/Atom.app`
  * `--build-dir` - Build the application in this directory.
  * `--verbose` - Verbose mode. A lot more information output.

## Troubleshooting

### macOS build error reports in atom/atom
* Use [this search](https://github.com/atom/atom/search?q=label%3Abuild-error+label%3Aos-x&type=Issues) to get a list of reports about build errors on macOS.