bootstrap

Install dependencies and build tools for WooCommerce iOS

SKILL.md

GitHub

Bootstrap the local environment for WooCommerce iOS.

First, check the required Xcode version and select it if available:

cat .xcode-version   # check required version
xcode-select -p      # check currently selected Xcode

If the selected Xcode doesn't match, look for the required version under /Applications/ and switch to it via xcode-select -s <path>. If it's not installed, note this to the user and proceed with the currently selected Xcode.

Then, ensure the correct Ruby version is active. The required version is in .ruby-version. Detect which Ruby version manager is available and use it:

  • rvm: rvm install ruby-$(cat .ruby-version) && rvm use ruby-$(cat .ruby-version)
  • rbenv: rbenv install $(cat .ruby-version) && rbenv local $(cat .ruby-version)
  • chruby / mise: activate the version from .ruby-version using the appropriate command

Verify with ruby --version before proceeding.

Then run the dependency install command:

bundle install && bundle exec rake dependencies

If the command fails:

  1. Report the failing step and error output
  2. If Bundler::GemNotFound or wrong Ruby version errors appear, ensure the correct Ruby version is active and retry
  3. If a8c-secrets decrypt fails, the decryption key is missing or stale — it does not block building or testing, only internal credentials are missing