macOS Developer Environment Setup

A collection of shell scripts to automate the setup of a macOS development environment and remove unnecessary preinstalled applications.

Features

• Modular Design: Each script focuses on a specific task and can be run independently
• Interactive Workflow: Scripts prompt before making changes
• Development Environment Setup:
  • Custom script environment with useful aliases and functions
  • Core development tools (VS Code, Cursor IDE, Ghostty terminal)
  • Node.js (via NVM) with LTS version
  • Python (via Miniconda)
  • Docker
  • ZSH customization with Zplug and Spaceship prompt
  • Common applications (Firefox, Chrome, Slack, Discord, Brave, Tor)
  • GNU command line tools (replacing macOS defaults)
  • Window management (Rectangle)
  • Media conversion utilities (mov2gif)
• Application Removal:
  • Safe removal of GarageBand, iMovie, and iWork suite
  • System cache cleanup
  • Disk space recovery

Prerequisites

• macOS (Tested on macOS Sequoia 15.3.1 on an M4 Max MacBook Pro)
• Administrator privileges
• Internet connection

Installation

1. Clone this repository:

   git clone https://github.com/skwid138/mac-environment-setup.git
   cd mac-environment-setup

2. Make the main scripts executable:

   chmod +x install.sh
   chmod +x remove.sh

3. Run the installation script:

   ./install.sh

Usage

Development Environment Setup

The install.sh script will guide you through the installation process, with prompts before executing each section:

1. Script Environment: Sets up a custom script environment with useful utilities
2. Base Setup: Installs Homebrew and CLI utilities (fortune, cowsay, lolcat, tmux)
3. Development Tools: Installs VS Code, Cursor IDE, Ghostty terminal, ffmpeg, jq, and other tools
4. Node.js Environment: Sets up NVM and installs the latest LTS version of Node.js
5. Python Environment: Installs Miniconda for Python development
6. Docker: Installs Docker Desktop
7. ZSH Customization: Sets up Zplug with Spaceship prompt and useful plugins
8. Common Applications: Installs Firefox, Chrome, Slack, Discord, Brave, and Tor
9. GNU Tools: Installs GNU coreutils, grep, sed, awk, and findutils to replace macOS defaults as well as installs the latest bash
10. Window Management: Installs Rectangle for window management
11. Media Utilities: Sets up mov2gif for converting .mov files to .gif

Each section can be installed independently by running the corresponding script directly:

./00-script-environment.sh
./01-base-setup.sh
./02-dev-tools.sh
./03-node-setup.sh
./04-python-setup.sh
./05-docker-setup.sh
./06-zsh-customization.sh
./07-common-apps.sh
./08-gnu-tools-setup.sh
./09-window-management-setup.sh
./10-media-utils-setup.sh

Application Removal

The remove.sh script helps you remove preinstalled macOS applications and clean up system caches:

1. GarageBand: Removes GarageBand and associated sound libraries
2. iWork Suite: Removes Pages, Numbers, and Keynote
3. iMovie: Removes iMovie and associated files
4. System Cache Cleanup: Clears various system caches to free up disk space

Run the removal script:

./remove.sh

Script Details

Installation Scripts

• 00-script-environment.sh: Creates a modular script environment with separate files for variables, paths, aliases, and functions. Downloads custom scripts from GitHub gists.
• 01-base-setup.sh: Installs Homebrew and essential CLI utilities.
• 02-dev-tools.sh: Installs development tools including VS Code, Cursor IDE, Ghostty terminal, GitHub CLI, Google Cloud SDK, jq, and ffmpeg.
• 03-node-setup.sh: Sets up Node.js using NVM and installs essential global npm packages.
• 04-python-setup.sh: Installs Miniconda and configures the environment for Python development.
• 05-docker-setup.sh: Installs Docker Desktop.
• 06-zsh-customization.sh: Installs and configures Zplug with plugins for ZSH enhancement, as well as custom ZSH configurations.
• 07-common-apps.sh: Installs commonly used applications like Firefox, Chrome, Slack, Discord, Brave, and Tor.
• 08-gnu-tools-setup.sh: Installs GNU core utilities, grep, sed, awk, and findutils to replace macOS defaults as well as installs the latest bash.
• 09-window-management-setup.sh: Installs Rectangle for window management and tiling.
• 10-media-utils-setup.sh: Downloads and sets up mov2gif utility from GitHub gist.

Removal Scripts

• remove_garageband.sh: Safely removes GarageBand and its associated components.
• remove_imovie.sh: Removes iMovie and its associated files.
• remove_iwork_suite.sh: Removes Pages, Numbers, and Keynote along with their container files.
• remove_other_apps.sh: Provides options to remove other preinstalled applications.
• clear_system_cache.sh: Cleans system caches to free up disk space.

Customization

Script Environment

The script environment creates the following structure in ~/code/scripts/:

• init.sh: Main script that sources all other scripts
• vars.sh: Environment variables
• paths.sh: PATH additions
• aliases.sh: Command aliases
• functions.sh: Utility functions
• cowsay_fortune_lolcat.sh: Fun terminal additions
• zsh_plugins.sh: ZSH plugin configuration with Zplug
• zsh_config.sh: ZSH custom configurations
• Tool-specific configs: For NVM, Conda, GCloud, etc.

You can modify these files to customize your environment.

Terminal Setup

The scripts install and configure Ghostty terminal with Zplug and Spaceship prompt for an enhanced terminal experience. You can customize the configuration by modifying:

• ~/.ghostty/: Ghostty terminal configuration
• ~/code/scripts/zsh_plugins.sh: ZSH plugins configuration
• ~/code/scripts/zsh_config.sh: ZSH keyboard shortcuts and completion settings

Future Enhancements

• Additional application installation options (e.g., productivity apps, media tools)
• System preference configurations
• Git configuration setup

License

MIT License

Acknowledgments

• Homebrew
• NVM
• Miniconda
• Docker
• Zplug
• Spaceship Prompt
• Ghostty Terminal
• Rectangle