# minamarkham/formation

💻 macOS setup script for front-end development

Repository: https://github.com/minamarkham/formation
Canonical: https://ross.abutalabs.com/products/formation
Homepage: http://slay.sh
Language: Shell
License: MIT
License Family: permissive
Topics: macos, laptop, development, setup, homebrew, beyonce, fresh-installs, eleventy
Last push: 2025-03-22T06:25:32+00:00

## Health v2 (maintenance only)
Score: 38/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 12, release rhythm 35, longevity 100
- inputs: {"age_days": 2968, "days_push": 529, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1781, forks 165 (observed 2026-08-28T04:05:35.530064+00:00)

## What it is
Formation is an idempotent shell script that sets up a macOS laptop for design and front-end development. It installs and configures developer tools, package managers, CLI utilities, and apps via Homebrew, and can be safely run multiple times on the same machine.

## Use cases
- set up a new mac for front-end development
- automate macOS laptop provisioning after a fresh install
- install homebrew packages and dev tools with one script
- keep my mac's development environment up to date
- configure a design and development machine from scratch
- script my mac setup so it's repeatable

## When to choose
- you want a one-command, opinionated macOS dev environment setup
- you do front-end or design work on a Mac and want common tools preinstalled
- you need an idempotent script safe to re-run for updates

## When to avoid
- you use Linux or Windows instead of macOS
- you want a fully customized setup and dislike the author's opinionated tool choices
- you prefer declarative configuration management like Ansible or Nix
- you're uncomfortable running shell scripts that modify system settings

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, cli, configuration-management, package-manager
- domain: developer-tools, web-development
- platform: cli
- tags: macos-setup, laptop-setup, homebrew, dotfiles, fresh-install, shell-script, front-end-development, command-line, automation, macos, shell

## Member repositories
- minamarkham/formation (main) score 38

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:35.530064+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-30T03:24:25.339872+00:00, confidence not recorded.
  - readme: https://github.com/minamarkham/formation (fetched 2026-08-28T04:05:35.530064+00:00, sha 58bde9f5074f)
  - homepage: http://slay.sh (fetched 2026-08-29T11:03:02.659648+00:00, sha a58f1d43f159)
- Data as of 2026-08-30T08:39:29.467469+00:00.