People often use rbenv to manage multiple Ruby versions, which comes in handy when you need to run a specific Ruby version on a project.
# Install Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)" # Install rbenv and ruby-build brew install rbenv # Set up rbenv integration with your shell rbenv init
Restart your terminal for changes to take effect.
Now you can install a new Ruby version. At the time of this writing, Ruby 2.6.6 is a fast and stable option. You’ll also want to install Bundler to manage Rubygem dependencies.
rbenv install 2.6.6 rbenv global 2.6.6 ruby -v > ruby 2.6.6p146 (2020-03-31 revision 67876) [x86_64-darwin19] gem install bundler -N
And that’s it! Head over rbenv command references to learn how to use different versions of Ruby in your projects.
Now jump down to the Install Node & Yarn section.
You may install Ruby directly through Homebrew.
# Install Homebrew /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" brew install ruby
Add the brew ruby path to your shell config:
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
Then relaunch your terminal and check your updated Ruby setup:
which ruby # /usr/local/opt/ruby/bin/ruby ruby -v
Yay, we are now running current stable Ruby!
To set up Bundler for managing Rubygem dependencies as well as Ruby executable paths, run:
gem install --user-install bundler
Then append your path file with the following, replacing the
X.X with the first two digits of your Ruby version.
echo 'export PATH="$HOME/.gem/ruby/X.X.0/bin:$PATH"' >> ~/.bash_profile
Then relaunch your terminal and check that your gem paths point to your home directory by running:
And check that
SHELL PATH: includes to a path to
Every time you update Ruby to a version with a different first two digits, you will need to update your path to match.
You will also need to add
--user-install to any
gem install statement you run.
Install Node & Yarn
The easiest way to install Node and Yarn is via Homebrew (which should already be installed after following the instructions above).
brew update brew install node brew install yarn
Then verify your installed versions:
node -v yarn -v
Now all that is left is to install Bridgetown!
gem install bridgetown -N
Create a new Bridgetown site at
./mysite, as well as run
bundle install and
yarn install automatically:
bridgetown new mysite cd mysite
Now you should be able to build the site and run a live-reload server:
$ yarn start
Try opening the site up in http://localhost:4000. See something? Awesome, you’re ready to roll! If not, try revisiting your installation and setup steps, and if all else fails, reach out to the Bridgetown community for support.
Top Top: Adding Concurrently Processes
Want to run even more background processes or change up your build tools? Take a look
at the provided
sync.js script and read up on the
Concurrently documentation to
see which options are available.