How do I install Courier on macOS?

Introduction

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.

Prerequisites

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

Installation

brew tap blutui/courier

brew install courier

courier

Additional steps for Firefox users

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

brew install nss

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

Authentication

Before using Courier, you need to generate a Blutui access token. Follow these steps:

1. In your Agency Console, click on your avatar in the top-right corner and choose Edit my profile.
2. Go to the Apps section in the sidebar.
3. Click Create token on the right, under the "Access tokens" section.
4. Name your token, e.g., "Work MacBook".
5. Set the token type to "Courier". Required permissions for Courier will be automatically selected.
6. Click Create token. Your Courier token will be displayed. Copy and store it securely, as it will only be shown this one time.

Using your Courier token

1. To securely add your access token to a token.txt file, use the following command:

read -s -p "Enter your Courier access token: " TOKEN && echo $TOKEN > token.txt

2. Log in to Courier using your token file:

courier login --token < token.txt

3. Remember to delete the token.txt file once you have successfully logged into Courier.

Once configured, you're ready to start pushing and pulling projects.

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

More resources