diff --git a/src/content/docs/zap.mdx b/src/content/docs/zap.mdx
index 1f9b6e25..4d7dee02 100644
--- a/src/content/docs/zap.mdx
+++ b/src/content/docs/zap.mdx
@@ -81,7 +81,17 @@ than you needing to go through some proprietary Shorebird agent.
- Visit [Shorebird's TestFlight link](https://testflight.apple.com/join/5zqR6tQx) and install the app.
+
+
+ 1. Download and install [TestFlight](https://apps.apple.com/app/testflight/id899247664)
+ from the App Store
+
+ 2. Visit [Shorebird's TestFlight link](https://testflight.apple.com/join/5zqR6tQx)
+
+ 3. Download and install the app
+
+
+
@@ -98,14 +108,11 @@ not required, to use Shorebird's MCP server.**
-
+
- 1. **If you already have the Shorebird MCP installed,
- [skip to step 3](#skip-mcp).** Otherwise, install the MCP.
-
- The Shorebird MCP isn't available in official plugin/MCP marketplaces
+ 1. The Shorebird MCP isn't available in official plugin/MCP marketplaces
yet, so you'll need to add a custom connector.

@@ -118,8 +125,15 @@ not required, to use Shorebird's MCP server.**
2. Use the default authentication settings, and authenticate the MCP using
your Shorebird account (via OAuth).
- 3. Create a new coding agent thread and connect it to
- your GitHub repo
+
+
+
+
+
+
+
+
+ 1. Create a new coding agent thread and connect it to your GitHub repo
- 4. Prompt your agent to build you an app using Shorebird Zap. You can use
+ 2. Prompt your agent to build you an app using Shorebird Zap. You can use
whatever prompt you'd like, but here's one that has worked well:
```text
@@ -230,6 +244,14 @@ Note: environment network settings may not be available via mobile app.
+
+What is "Shorebird Companion"?
+
+Some parts of the app are called Shorebird Companion, and others are called
+Shorebird Zap. Neither name is final, and they will likely change.
+
+
+
## Feedback
Shorebird Zap is a prototype, and your feedback shapes where it goes next. Reach