Skip to main content
Orchard separates packages into three sources — Homebrew CLI tools, Homebrew Cask GUI apps, and Mac App Store applications — each managed by its own list file. To add a package, you edit the relevant list file and re-run provision.sh. No changes to the install scripts themselves are required.
You can find Homebrew package names at formulae.brew.sh and cask names at formulae.brew.sh/cask.

​
Homebrew CLI packages

brew-packages/package-list.bash defines the command-line tools Orchard installs via brew install. The default list looks like this:
brew-packages/package-list.bash
#!/bin/bash -euo pipefail

package_list=(\
  'devcontainer' \
  'mas' \
)

export package_list
To add a package, append its Homebrew formula name as a quoted, backslash-continued entry in the package_list array. For example, to add git-lfs:
brew-packages/package-list.bash
#!/bin/bash -euo pipefail

package_list=(\
  'devcontainer' \
  'mas' \
  'git-lfs' \
)

export package_list

​
Homebrew Cask GUI apps

cask-packages/package-list.bash lists GUI applications installed via brew install --cask. These are full macOS applications distributed through Homebrew’s cask registry.
cask-packages/package-list.bash
#!/bin/bash -euo pipefail

package_list=(\
  '1password' \
  'docker' \
  'gcloud-cli' \
  'google-chrome' \
  'microsoft-teams' \
  'visual-studio-code' \
  'zoom' \
)

export package_list
Cask names are listed at formulae.brew.sh/cask. To add an app, add its cask name to the array. For example, to add Figma:
cask-packages/package-list.bash
#!/bin/bash -euo pipefail

package_list=(\
  '1password' \
  'docker' \
  'gcloud-cli' \
  'google-chrome' \
  'figma' \
  'microsoft-teams' \
  'visual-studio-code' \
  'zoom' \
)

export package_list

​
Mac App Store apps

mac-app-store/application-list.bash is empty by default. Orchard uses the mas CLI to install App Store apps, but you must have already purchased or downloaded each app on your Apple ID before provisioning.
mac-app-store/application-list.bash
#!/bin/bash -euo pipefail

application_list=()

export application_list
To add an app, put its exact App Store name as a string in the application_list array. Orchard searches the App Store by name and installs the first exact match it finds. For example, to add Xcode:
mac-app-store/application-list.bash
#!/bin/bash -euo pipefail

application_list=(
  'Xcode'
)

export application_list
The app name must match the App Store listing exactly. If the search returns no exact match, the install step will fail. You can verify the name by searching for the app in the Mac App Store app or at apps.apple.com.

​
Applying your changes

After editing any package list file, re-run provisioning to install your additions. Orchard skips packages that are already installed, so it’s safe to run repeatedly.
1

Find the package name

Look up the exact name for the package you want to add:
2

Edit the package list file

Open the relevant file and add the package name as a new entry in the array, following the same quoting and formatting as existing entries.
3

Re-run provision.sh

From the Orchard root directory, run:
./provision.sh
Orchard will install only the new packages and skip everything already present.