> ## Documentation Index
> Fetch the complete documentation index at: https://orchard.andrewshawcare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Orchard: macOS workstation provisioning in one command

> Orchard automates macOS developer workstation setup — apps, tools, and system preferences — with a single script. Fully configured in minutes.

Orchard is a macOS workstation provisioning tool that sets up your entire developer environment with a single command. It installs essential applications, configures system preferences, and prepares your machine for development work — reproducibly and reliably, every time.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Clone the repo and run provision.sh to set up your machine in minutes.
  </Card>

  <Card title="What Gets Installed" icon="box-open" href="/installed/applications">
    See every app and tool that Orchard installs on your machine.
  </Card>

  <Card title="Customization" icon="sliders" href="/customization/adding-packages">
    Learn how to add your own packages and configure system settings.
  </Card>

  <Card title="Command Reference" icon="terminal" href="/reference/commands">
    Full reference for provision.sh, scaffold.sh, and test.sh.
  </Card>
</CardGroup>

## How Orchard works

Orchard runs a series of modular install scripts, each responsible for a single aspect of your workstation. The main `provision.sh` script orchestrates everything — you never need to run individual scripts manually.

<Steps>
  <Step title="Clone the repository">
    Download Orchard to your local machine using Git.
  </Step>

  <Step title="Run provision.sh">
    Execute a single script to install all apps and configure your system.
  </Step>

  <Step title="Customize as needed">
    Edit package lists and add your own modules to tailor the setup to your workflow.
  </Step>
</Steps>

<Note>
  Orchard is designed for macOS. It requires macOS and an internet connection to install Homebrew, applications, and developer tools.
</Note>