Courier is a development tool that allows you to write code locally and view the results instantly. Once you're satisfied with your work, you can push it to your Blutui project for review. Courier is designed to offer the best of both worlds by integrating local workflow with the cloud, thereby making development faster, more enjoyable, and more creative. This guide outlines the steps to install and set up Courier on a macOS machine.


  • Homebrew installed.
  • Administrative access for local setup and cloud connectivity.



Add the Courier Homebrew Tap

Firstly, open your terminal and run the following command:

brew tap blutui/courier

Install Courier

Secondly, continue in your terminal with:

brew install courier

Courier will require administrative access for running projects locally and connecting to Blutui.


Run the installer

Next, execute the following command:

courier install

You will be prompted to enter your admin password.


Verify the installation

Lastly, to confirm that Courier is successfully installed, run:


This will display a list of available commands, confirming Courier is now successfully installed.

Additional steps for Firefox users

If you're using Firefox, you'll need to install Network Security Services (NSS):


Install NSS

brew install nss

Run the installer again

courier install

Now you should be able to use courier watch on Firefox.



Generate a Courier token

  1. Navigate to your Agency Console and click on your avatar in the top-right corner.
  2. Choose "Edit my profile."
  3. Go to the "Apps" section from the sidebar.
  4. Click the "Create token" button on the right-hand side.
  5. Name your token (e.g., "Work MacBook") and click "Create"

Remember, the token will expire in one year, so plan to renew it accordingly.


Login to Courier

Copy your newly created token and run the following command in your terminal:

courier login [your-courier-token]

And there you have it—a complete guide to installing, and setting up Courier on macOS!

More resources

How do I pull a project onto my machine?

Learn how to pull your project from Blutui onto your machine for development.

How do I preview a project onto my machine?

Learn how to preview your project on your machine while in development.

How do I push a project to Blutui?

Learn how to push your project code from your machine to Blutui.

Was this helpful?