Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Unlinking multi projects update #137

Merged
merged 2 commits into from
Feb 6, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 47 additions & 2 deletions docs/cli/commands/unlink.mdx
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: Unlink a project from Globe
title: Unlink Projects from Globe
---

The `unlink` command removes any previously linked projects from the current local project. This will prevent you from deploying the project to Globe.

## Usage
## Unlinking a Single Project

```bash
globe unlink
Expand All @@ -13,3 +13,48 @@ globe unlink
## How it works

The command removes the `.dart_tool/dart_globe` directory from the local project. This directory stores metadata about the project, which is used to identify the project when deploying to Globe.

## Unlinking Multiple Projects (e.g., Mono-Repos)
In multi-project setups, the unlink command allows you to select which project to unlink from the workspace.

Run the same command in your workspace directory:
```bash
globe unlink
```

The CLI displays a list of linked projects for you to select:
```bash
🔺 Select project:
❯ ◉ blog-backend-369d
◯ blog-frontend
```

### Examples
```bash
globe unlink --project="blog-frontend"
```

```bash
globe unlink --project="blog-backend-369d"
```

Alternatively, you can select a project interactively:

```bash
~/Projects/OpenSource/dart-blog | on main >1 !3 ?1 globe unlink
🔺 Select project:
❯ ◉ blog-backend-369d
◯ blog-frontend
```

### Project-Specific Commands

In multi-project setups, you can also run commands specific to a single project by passing its **ID** or **Slug** as an argument.

#### Examples

Unlink a specific project:

```bash
globe unlink --project="blog-frontend"
```
alexdukeinvertase marked this conversation as resolved.
Show resolved Hide resolved
Loading