Installing & Setting Up Archipelago

What you'll learn

• Installing the Archipelago CLI from pub.dev
• Running archipelago doctor to verify your environment
• Authenticating with your Archipelago account
• Understanding the CLI output and common troubleshooting steps

Prerequisites

Before you begin, make sure you have the following installed:

• Flutter SDK (3.22 or later)
• Dart SDK (3.4 or later)
• Git (2.0 or later)

Step 1: Install the CLI

Install Archipelago globally via pub.dev:

dart pub global activate archipelago_cli

Verify the installation:

archipelago --version

Step 2: Run Doctor

The doctor command checks your environment for required tools and configurations:

archipelago doctor

This verifies:

• Flutter and Dart SDK versions
• Git availability
• Mason CLI installation
• Network connectivity to the brick registry

Step 3: Authenticate

Log in to your Archipelago account to access your tier's bricks:

archipelago auth login

This opens a browser window for authentication. Once complete, your session token is stored locally.

Step 4: Verify Setup

Run a quick check to confirm everything is working:

archipelago auth status

You should see your account email, subscription tier, and available brick count.

Troubleshooting

Issue	Solution
command not found	Ensure ~/.pub-cache/bin is in your PATH
Doctor reports missing Mason	Run dart pub global activate mason_cli
Auth fails to open browser	Use archipelago auth login --no-browser for manual token entry

Next Steps

Now that you have Archipelago installed, head to Creating Your First Project to scaffold a full monorepo.