# Review bindings

When a connection finds things (Stripe products, GitHub repos, Firebase projects, domains), ShipVitals binds each to a project. The binding review is where you check those bindings, move what's wrong, split shared accounts between projects, and confirm what ShipVitals suggested. What you choose yourself is saved as you go: a resource you put in a project is bound there, and a project you create for one is active, without a confirm. **Confirm … bindings** accepts the matches ShipVitals suggested, and stays at the bottom of the window while any wait.

Only the owner and admins can review bindings (see [Connect a service](connect-a-service.md)).

## Open the review

Any of these opens **Review bindings**:

- In **Connections**, the link under the heading ("4 new resources to review"), or the **Review** card in **Suggested**.
- **Review bindings** on a test result that found resources.
- The command palette (`⌘K` / `Ctrl K`): **Review bindings**.
- A project's Overview: **Review bindings** (see [Projects](projects.md)).

The heading counts what's there, for example "10 projects · 41 resources", with a line under it: "38 exact, pre-accepted · 2 to check · 1 shared · 3 unmatched" (the unmatched count shows only when there are some). When nothing is waiting: "Nothing to review yet. What your connections find shows up here."

## Read the list

The resources are grouped by project. Each row shows the **Resource**, its **Match**, **Why** it matched, and its **Project**.

- **Exact**, **Pre-accepted**: an id matched. Nothing to do.
- **Probable** or **Suggested**, **Needs a look**: a name, domain or address matched. Check it.
- **Shared · …**: the resource serves several projects (see [Split a shared resource](#split-a-shared-resource)).
- Under **Not matched**: nothing matched it to a project ("Nothing matched it to a project."). GitHub repos that only GitHub knows are here: a repo doesn't become a project on its own. Choose a project for the ones you run (or **Create project**) and leave the rest; they aren't counted as waiting.

Choose a row (click it, or `j` `k`) and the **Details** panel shows its **Service**, **Id**, where it's **Bound to**, and **Other places it could go**.

Rows bound automatically are listed above the grid: "Bound automatically: …."

## Accept a match

Press **Accept** in the **Details** panel, or `a` on the row (the cursor moves to the next row). The row says **Accepted**, and the toast says "… accepted for …." with **Undo**.

## Move a resource to another project

1. Press the row's project (or `e`, `Enter` or `F2` on the row).
2. Choose a project under **Projects**, or under **Other**: **Create project** or **Ignore**.
3. The toast says "… moved to …." with **Undo**, and the row says **Your choice** and **Bound**. **Create project** makes a project named after the resource ("… created with …."); it is active as soon as the change is saved, and you can rename it in its **Settings**. A resource you put in a project that is itself still **Proposed** says **Waits for Confirm**: it is bound when you confirm that project.

Or press **Move to …** in the **Details** panel, or drag the row onto a project's heading.

**Ignore** leaves the resource out of every project: "… ignored."

To change several at once, tick their boxes (or `x`), or **Select all**. The bar says "3 selected", with **Accept**, **Bind to…**, **Ignore** and **Clear selection**.

## Proposed projects

A project that ShipVitals proposed from what it found has a **Proposed** heading, where it came from ("from repo …", "from Stripe product …") and its kind. A repo is proposed as a project only when another connection points at it (a hosting project that deploys it, a Firebase project named in it, a Sentry project of its name).

- To rename it, type in its name and press `Enter` (`Esc` undoes the typing). The toast says "… renamed …."
- To change its kind, choose **Commercial**, **OSS**, **Public good** or **Client-funded**.
- To merge it into another project, press **Merge into…** (or `m` on any of its rows). In **Merge … into…**, choose the project under **Merge into** and press **Merge**. Its resources move, and the proposed project goes when you confirm: "… merged into …."

A proposed project becomes a real project when you confirm. If your plan has no room for it, it stays proposed.

## Split a shared resource

A resource that serves several projects (one Apple Developer team, one MailerSend account) is **Shared**. Its cost can be divided between them.

1. Choose the row and press **Edit the split** in the **Details** panel (or `s`), or press the row's **Shared · …** label. The dialog says **Split …**: "How its cost divides between the projects it serves."
2. Choose the **Method**:
   - **Equal**: the same share each.
   - **Fixed %**: type each project's share (on a phone, the − and + buttons). The total shows under them ("Total 100%"). Under 100% is fine: the rest goes to **Unallocated** (workspace overhead). Over 100%: "The shares add up to …; they can't be over 100%."
   - **Usage-weighted**, where the service has something to measure: "By messages sent per project, last month."
3. Check the preview of last month under the rule ("… under this rule"): each project's share and amount as the rule gives them, with **Unallocated** (only what a fixed rule leaves over) and the **Total**. A proposed project "waits for the confirm": it shows the share it gets once confirmed, and until then its cost stays unallocated. When nothing was billed last month, the shares still show and the amounts read "—".
4. Tick **Apply to past months too** to recompute past months as well ("3 past months change, … to …."). Otherwise "Applies from today."
5. Press **Save split**. The toast says "Split saved for …." with **Undo** ("The split for … is back as it was.").

## Undo

Every change acts at once and can be undone for 10 seconds: press **Undo** in the toast, or `u`. The toast says "Undone: …". After 10 seconds: "Nothing to undo. A change can be undone for 10 seconds."

## Confirm

Press **Confirm … bindings** (for example **Confirm 41 bindings**; or `⌘Enter` / `Ctrl+Enter`). The number is how many suggested bindings wait; when none do, there is nothing to confirm and the button isn't shown. The page says "41 bindings confirmed." and, when it applies, "2 projects are active." and "1 domain is watched now.", with **See projects**.

### When someone else changed it

Two admins can review at once. If someone confirmed changes after you opened the review, the page says "… changed 3 bindings a minute ago. Both sets of changes are shown; confirm again to save them." Check the list and press **Confirm … bindings** again. **Dismiss** hides the message.

## On a phone

Each resource is a card with its match, why, and its project as a list to choose from (which also has **Create project** and **Ignore**). A card that needs a look has **Accept**. There's no **Details** panel: to split a shared resource, press its **Shared · …** label, which opens **Split …** full screen. **Confirm … bindings** stays at the bottom of the screen.

## Test results for a repo

A GitHub repo with no test results yet has **Set up CI** on its row. See [CI and push metrics](ci-and-push-metrics.md).

## When it doesn't work

| The page says | What to do |
|---|---|
| "That change didn't save. It is tried again before the confirm." | Nothing to do; press **Confirm … bindings** when ready. |
| "The bindings didn't confirm. Nothing changed; try again." | Check your connection and confirm again. |
| "… goes to one project, so there's nothing to split." | Only a shared resource has a split. |
| "… is already a project. Only a proposed one can be merged." | Move its resources one by one instead. |
| "There's no other project to merge it into." | Create or keep another project first. |
| "Couldn't preview this split. Saving it still works." | Press **Save split** anyway, or try again. |
| "Your other changes aren't saved yet, so the split waits. Try again in a moment." | Wait a few seconds and press **Save split** again. |

## Keyboard

The list is one stop in the `Tab` order; these keys work on it.

| Key | Does |
|---|---|
| `j` `k` (or `↓` `↑`) | Move between rows |
| `x` (or `Space`) | Select the row |
| `e`, `Enter` or `F2` | Change the row's project |
| `a` | Accept |
| `m` | **Merge into…** for the row's proposed project |
| `s` | **Edit the split** of a shared row |
| `u` | Undo the last change |
| `⌘Enter` / `Ctrl+Enter` | **Confirm … bindings** |

The keys are listed under the list, too. Single keys follow **Single-key shortcuts** in [Account settings](account-settings.md); `Enter` and `F2` always work.
