# Orchard

## Docs

- [Add Homebrew packages and apps to your Orchard setup](https://orchard.andrewshawcare.com/customization/adding-packages.md): Edit the package list files to control which Homebrew CLI tools, GUI apps, and Mac App Store applications Orchard installs on your machine.
- [Create and register custom Orchard provisioning modules](https://orchard.andrewshawcare.com/customization/new-modules.md): Use scaffold.sh to generate a new module, write your install logic, and register it with provision.sh so it runs as part of every provisioning run.
- [Customize macOS system settings configured by Orchard](https://orchard.andrewshawcare.com/customization/system-settings.md): Learn which macOS defaults Orchard configures out of the box, and how to change values for keyboard, mouse, trackpad, Dock, and screen lock behavior.
- [Every app and tool Orchard installs on your Mac](https://orchard.andrewshawcare.com/installed/applications.md): A complete list of every GUI app, CLI tool, and AI assistant that Orchard installs on your Mac, including how each one is installed.
- [macOS system preferences Orchard configures automatically](https://orchard.andrewshawcare.com/installed/system-preferences.md): Every macOS system preference Orchard sets automatically, organized by category, with explanations of what each setting does and why it helps developers.
- [Orchard: automated macOS workstation provisioning](https://orchard.andrewshawcare.com/introduction.md): Learn what Orchard is, what problem it solves, and what gets configured — apps, system preferences, and developer tools — all in a single run.
- [Get started with Orchard: provision your Mac in minutes](https://orchard.andrewshawcare.com/quickstart.md): Provision your macOS workstation from scratch — clone the repository, run one script, and let Orchard install apps and configure your system preferences.
- [Orchard commands: provision.sh, scaffold.sh, test.sh](https://orchard.andrewshawcare.com/reference/commands.md): Reference for every Orchard command: provision.sh to set up your machine, scaffold.sh to create new modules, and test.sh to verify your setup.
- [Troubleshoot common Orchard provisioning problems](https://orchard.andrewshawcare.com/reference/troubleshooting.md): Solutions for the most frequent problems you may encounter when running Orchard, including permission errors, failed installs, and Dock or App Store issues.