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
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:
courier
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.
Authentication
Generate a Courier token
- Navigate to your Agency Console and click on your avatar in the top-right corner.
- Choose "Edit my profile."
- Go to the "Apps" section from the sidebar.
- Click the "Create token" button on the right-hand side.
- 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.