This repository provides a comprehensive guide and automated scripts for setting up a macOS development environment. It targets developers who want to streamline the installation and configuration of a wide array of tools, from core utilities and text editors to data analysis stacks, big data platforms, cloud services, and mobile development environments. The primary benefit is a significantly reduced setup time and a consistent, organized development environment.

How It Works

The project utilizes a modular approach with a central .dots script that orchestrates various shell scripts (osxprep.sh, brew.sh, pydata.sh, etc.). These scripts automate tasks like OS updates, Xcode Command Line Tools installation, Homebrew package management, OS X default configurations, and the setup of specific toolchains (Python data science, AWS, JavaScript, Android). The design emphasizes customization, allowing users to select which components to install via command-line arguments to the .dots script.

Quick Start & Requirements

• Install/Run: Clone the repository and execute .dots <section_name> (e.g., ./.dots brew osx pydata).
• Prerequisites: macOS, Git, internet connection. Some scripts may require specific OS versions (tested on 10.10-10.11).
• Setup Time: Varies based on selected sections; brew.sh can take a significant amount of time due to source installations.
• Links: GitHub Repo

Highlighted Details

• Extensive coverage of development stacks: Python data analysis (NumPy, Pandas, Scikit-learn), Big Data (Spark, Hadoop), Cloud (AWS CLI, Heroku), Web Dev (Node.js, LESS), and Android.
• Dotfiles and scripts for Vim, Bash, iTerm2, and Sublime Text customization.
• Automation leverages Homebrew and Homebrew Cask for package management.
• Includes detailed explanations and usage examples for each tool and section.

Maintenance & Community

The repository is actively maintained by Donne Martin. Contributions, bug reports, and suggestions are welcomed. Contact information is available on the author's GitHub page.

Licensing & Compatibility

Licensed under the Apache License, Version 2.0. This license permits commercial use and linking with closed-source projects.

Limitations & Caveats

The README explicitly states it was tested on macOS 10.10 Yosemite and 10.11 El Capitan, so compatibility with newer macOS versions is not guaranteed without potential modifications. Some sections, like Android development, are noted as "under development." The project's reliance on specific Homebrew formulae and shell scripting might require adjustments for future macOS or Homebrew updates.