# nicolashery/mac-dev-setup

A beginner's guide to setting up a development environment on macOS

Repository: https://github.com/nicolashery/mac-dev-setup
Canonical: https://ross.abutalabs.com/products/mac-dev-setup
Language: Shell
License Family: other
Last push: 2024-03-05T16:42:41+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 5023, "days_push": 911, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5757, forks 896 (observed 2026-08-28T04:09:29.236344+00:00)

## What it is
A beginner's guide documenting how to set up a full development environment on macOS, covering tools like iTerm2, Homebrew, Git, VS Code, and languages such as Python, Node.js, and Ruby. It is a curated tutorial/reference document rather than executable software.

## Use cases
- set up a new MacBook for software development
- learn how to install Homebrew, Git, and VS Code on macOS
- configure Python, Node.js, and Ruby on a fresh Mac
- reinstall macOS and need a reminder of dev environment steps
- guide for friends new to programming on a Mac
- set up PostgreSQL, Redis, and Elasticsearch locally on macOS

## When to choose
- you are new to Mac and want a step-by-step developer environment setup
- you want a simple, opinionated checklist for reinstalling macOS
- you need a reference covering common languages and dev tools on macOS

## When to avoid
- you need automated, reproducible provisioning (use dotfiles or Ansible/Nix instead)
- you require up-to-date instructions for the latest macOS versions
- you need a runnable tool rather than a written guide

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: developer-tools, cli, documentation
- domain: developer-tools, tutorials
- platform: -
- tags: setup-guide, macos-development, beginner-guide, environment-setup, shell-scripts, command-line, macos

## Member repositories
- nicolashery/mac-dev-setup (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:29.236344+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:53:15.906527+00:00, confidence not recorded.
  - readme: https://github.com/nicolashery/mac-dev-setup (fetched 2026-08-28T04:09:29.236344+00:00, sha 95948715c898)
- Data as of 2026-08-30T08:39:29.467469+00:00.