Web & Account Guide

archipelago.banuacoder.com is the customer portal for Archipelago. Everything that the CLI needs — authentication tokens, subscription state, and Enterprise repo access — is managed here.

Sign Up / Sign In

Archipelago uses OAuth exclusively; there is no email/password signup.

Supported providers:

Provider	Button label
GitHub	"Continue with GitHub"
Google	"Continue with Google"

Click Get Started on the home page (or go to /login) and choose a provider. On first login your account is created automatically and you are redirected to the dashboard.

GitHub username

If you sign in with GitHub, your GitHub username is captured automatically and pre-filled in your profile. Enterprise users need their GitHub username on file before generating a license key — signing in with GitHub avoids a manual step later.

Get a CLI API Token

The CLI must be authenticated before it can generate code or download bricks. There are two ways to get a token.

Interactive (recommended for local dev)

Run the following command. The CLI opens your browser automatically:

archipelago auth login --interactive

The browser lands on /cli/authorize, which shows your device name and platform and asks you to confirm. After you click Authorize, the page shows a token once. Copy it and paste it at the CLI prompt (Paste your API token:).

How it works

The CLI passes device_id, device and platform as query parameters. The authorization screen creates a CLI token bound to that device ID.

Manual token (CI / server environments)

For environments where a browser is not available:

1. Go to Dashboard → CLI Tokens (/dashboard/cli-tokens).
2. Click New Token, enter a name (e.g. github-ci).
3. Copy the token — it is shown once and cannot be retrieved later.
4. Pass it to the CLI:

archipelago auth login --token <your-token>

Managing tokens

The CLI Tokens page (/dashboard/cli-tokens) lists all active sessions with last-used timestamps, device names, and IP addresses. You can:

• Revoke a single token — click the trash icon next to any token.
• Revoke all tokens — click Revoke All Sessions. This signs out every device at once.

Session limits

Each plan has a concurrent session limit. If you hit the limit, revoke old tokens before generating a new one.

Subscription & Billing

Visit Dashboard → Subscription (/dashboard/subscription) to view your current plan and order history.

Plans

Plan	Price	Scaffold quota	Bricks
Free	$0 / forever	3 per month	Core set
Pro	$79 one-time	Unlimited	Full Pro set
Enterprise	$199 one-time	Unlimited	All bricks + source

The pricing page (/pricing) shows the price that checkout charges on the day you buy.

How to Subscribe

1. Go to /pricing or click Upgrade in the dashboard.
2. Choose Pro or Enterprise and click Buy.
3. You are redirected to a Lemon Squeezy checkout page (international payments, all major cards).

Lemon Squeezy is the only payment provider. Prices are in USD.

After a successful payment, Lemon Squeezy sends a webhook that upgrades your account role. Refresh the dashboard; your tier badge updates immediately.

Promo / discount codes

If you have a promo code, enter it on the Lemon Squeezy checkout page in the Discount code field. Free-trial promo codes can also be activated from the CLI:

archipelago auth activate --promo <code>

Generation Quota

The Free tier allows 3 full project scaffolds per calendar month (Jakarta time, WIB). Each successful archipelago create counts as one use, and the count resets on the first day of the next month. The dashboard and the CLI show the reset date.

View remaining quota

The dashboard home page (/dashboard) shows your quota card:

• Used — how many scaffolds you have run.
• Remaining — how many you have left (max 3 for Free).
• Unlimited — shown for Pro and Enterprise accounts.

What happens when you run out

The CLI throws a GenerationLimitException and prints:

Generation limit reached (3/3 used).
Upgrade to Pro or Enterprise for unlimited scaffolds.

The error payload also includes an upgrade_url pointing to /pricing.

To continue generating: upgrade to Pro or Enterprise from /pricing or /dashboard/subscription. Your quota becomes unlimited immediately after the webhook is processed.

Brick installs are not counted

Only archipelago create counts toward the quota. Adding bricks with archipelago generate <brick> does not consume a generation.

Refund Requests

Archipelago offers a satisfaction guarantee. To submit a refund request:

1. Go to Dashboard → Subscription (/dashboard/subscription).
2. Find the order you want a refund for in the Order History table.
3. Click Request Refund (visible only while the order is still eligible).
4. Enter a reason (10–1 000 characters) and submit.

You will receive a confirmation email. The team reviews requests within 2–3 business days and will contact you at your account email.

Eligibility

The Request Refund button is only shown when the order passes the eligibility check (RefundService::eligibleForRefund). If the button is not visible, the order is no longer eligible.

Enterprise: License Key & GitHub Repo Access

Enterprise subscribers get full brick source code via a private GitHub repository, plus a license key for the CLI.

Prerequisites

Before generating your license key:

1. Make sure your GitHub username is set in your profile (/dashboard/profile). If you signed in with GitHub, this is pre-filled.
2. Confirm your account has the Enterprise role (the Subscription page shows Enterprise in the tier badge).

Generate your license key

1. Go to Dashboard → Subscription (/dashboard/subscription).
2. In the Enterprise section, click Generate License Key.
3. A license key (arch-ent-<uuid>) is created and displayed on the page.
4. A GitHub collaborator invitation is sent to your GitHub username for the enterprise repository.

One-time generation

The license key is generated once. The Generate License Key button is replaced by Resend Invite after the key exists.

Accept the GitHub invitation

Check your GitHub notification email (or https://github.com/notifications) for an organization invitation. Accept it within 7 days — invitations expire automatically.

Resend the invitation

If your invitation expired or you missed it:

1. Go to Dashboard → Subscription.
2. Click Resend Invite in the Enterprise section.
3. A fresh invitation is sent to the GitHub username on file.

TIP

For a full guide on cloning the enterprise repo, forking it, and configuring the CLI to use your fork, see Enterprise.

Theme Builder

The Theme Builder at /theme-builder is a publicly accessible Flutter WASM app. You can open it without an account and customise colours, typography, and spacing interactively.

Exporting a theme requires a Pro or Enterprise subscription. When you click Export, the app calls /api/theme-builder/export-check:

• Unauthenticated → redirected to /login?redirect=/theme-builder.
• Free tier → export is blocked; a prompt to upgrade is shown.
• Pro / Enterprise → export proceeds immediately.
• Promo trial → treated as the trial's tier while it is active.

The response also has a can object (exportJson, exportTailwind, uiKitTheme) and the plan name to show (tierLabel: Guest, Free, Pro or Team). The page and the endpoint build them in one place (ThemeBuilderEntitlements), so they always agree. Copying the JSON to the clipboard is never gated.

The dashboard also has a shortcut at /dashboard/theme-builder that opens the same embedded builder within the authenticated portal.

For a full walkthrough of the Theme Builder UI and variable reference, see Theme Builder.

Brick Catalogue

Browse all available bricks at Dashboard → Bricks (/dashboard/bricks), or without an account at /bricks. Bricks are grouped by category (Scaffolding, Shared Packages, Infrastructure SDKs, Features, UI, DevTools, etc.) and labelled with their minimum tier (Free, Pro, or Enterprise).

The catalogue always shows the full brick list — tier labels indicate which bricks you can download with your current plan, not which bricks are hidden.

For CLI install instructions and per-brick documentation, see the Brick Catalog.