mac-setup

This repository is the source for a guide on setting up a development environment on a new Mac. The guide is published as a website at sourabhbajaj.com/mac-setup and is intended for anyone getting started on a fresh macOS installation, from experienced programmers who want a reference checklist to beginners who need step-by-step instructions. It works equally well as a one-time walkthrough or as a reference to return to when installing a specific tool.

The languages and environments covered include Node (JavaScript), Python, C++, and Ruby. Alongside those, the guide covers useful command-line tools and daily-use desktop applications. The README notes that even if you do not write code in all of those languages directly, many command-line tools have them as dependencies, so having them installed tends to be broadly useful.

The guide is built with Docusaurus, a static site generator designed for documentation. The project runs automated checks to verify that links in the content remain valid over time. Both a test workflow and a URL validation workflow are listed in the repository's CI setup.

The project is MIT licensed and openly maintained. It is actively looking for contributors to add support for additional libraries and languages, and a contribution template is provided in the repository for anyone who wants to help extend or update the documentation. Most of the actual guide content lives on the published website rather than in the repository README itself.