Skip to content
Guides

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).

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).

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).
  • 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.

When it doesn't work

  • The page says
    "That change didn't save. It is tried again before the confirm."
    What to do
    Nothing to do; press Confirm … bindings when ready.
  • The page says
    "The bindings didn't confirm. Nothing changed; try again."
    What to do
    Check your connection and confirm again.
  • The page says
    "… goes to one project, so there's nothing to split."
    What to do
    Only a shared resource has a split.
  • The page says
    "… is already a project. Only a proposed one can be merged."
    What to do
    Move its resources one by one instead.
  • The page says
    "There's no other project to merge it into."
    What to do
    Create or keep another project first.
  • The page says
    "Couldn't preview this split. Saving it still works."
    What to do
    Press Save split anyway, or try again.
  • The page says
    "Your other changes aren't saved yet, so the split waits. Try again in a moment."
    What to do
    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
    j k (or ↓ ↑)
    Does
    Move between rows
  • Key
    x (or Space)
    Does
    Select the row
  • Key
    e, Enter or F2
    Does
    Change the row's project
  • Key
    a
    Does
    Accept
  • Key
    m
    Does
    Merge into… for the row's proposed project
  • Key
    s
    Does
    Edit the split of a shared row
  • Key
    u
    Does
    Undo the last change
  • Key
    ⌘Enter / Ctrl+Enter
    Does
    Confirm … bindings

The keys are listed under the list, too. Single keys follow Single-key shortcuts in Account settings; Enter and F2 always work.