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
- Press the row's project (or
e,EnterorF2on the row). - Choose a project under Projects, or under Other: Create project or Ignore.
- 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(Escundoes 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
mon 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.
- 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." - 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."
- 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 "—".
- Tick Apply to past months too to recompute past months as well ("3 past months change, … to …."). Otherwise "Applies from today."
- 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.
| 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
jk(or↓↑)- Does
- Move between rows
- Key
x(orSpace)- Does
- Select the row
- Key
e,EnterorF2- 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
| 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; Enter and F2 always work.