From f8d94179ea770ba25807fe5d814fab8374a04d5c Mon Sep 17 00:00:00 2001
From: Thinal N Pethiyagoda <thinal@sansalabs.co>
Date: Sun, 5 Apr 2026 21:32:01 +0530
Subject: [PATCH 1/3] docs: update sharing, download code, and App Store deploy
 for Apple restrictions

- Sharing: replaced direct share link flow with Appsmith QR code workflow, noting that recipients need the Appsmith app installed to scan the QR code
- Download Code: restricted to web only, updated steps to use the <> button with download link sent via email
- Deploy to App Store: restricted to web only, commented out mobile submission steps
---
 getting-started/deploy-app-store.mdx |  8 +++++++-
 getting-started/download-code.mdx    | 16 ++++++++++++++++
 getting-started/sharing-app.mdx      | 16 ++++++++++++++++
 3 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/getting-started/deploy-app-store.mdx b/getting-started/deploy-app-store.mdx
index 4bc014f..c2d00f9 100644
--- a/getting-started/deploy-app-store.mdx
+++ b/getting-started/deploy-app-store.mdx
@@ -5,6 +5,10 @@ description: "Publish your Vibecode app to the Apple App Store with Expo Launch"
 
 Ready to share your app with the world? Vibecode makes it easy to publish your app directly to the Apple App Store. Follow this step-by-step guide to submit your first build.
 
+<Note>
+  Due to Apple's restrictions, deploying to the App Store is only available on the web app.
+</Note>
+
 <iframe src="https://www.youtube.com/embed/bJYwrB31PsQ" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
 
 ## Before You Start
@@ -49,15 +53,17 @@ You can also run the `/appstore-preflight` skill directly in the chat at any tim
 
 ### Step 1: Start the Submission
 
+{/*
 **On Mobile App:**
 1. Open your project in Vibecode
 2. Tap the **app name** at the top
 3. In the dropdown menu, select **Publish on App Store**
 4. Tap **Get Started** on the welcome screen
+*/}
 
 **On Web App:**
 1. Open your project in Vibecode
-2. Click the **Share** button at the top right
+2. Click the **Deploy** button at the top right
 3. Select **Deploy to App Store**
 4. Click **Get Started** on the welcome screen
 
diff --git a/getting-started/download-code.mdx b/getting-started/download-code.mdx
index bbb28b0..cba00cb 100644
--- a/getting-started/download-code.mdx
+++ b/getting-started/download-code.mdx
@@ -5,6 +5,21 @@ description: "Download and use your generated code"
 
 Vibecode allows you to download your code and use it in your own development environment. Whether you want to use Cursor, VS Code, or any other IDE, you can export your code and continue building. This gives you full control and flexibility to customize your app however you need.
 
+<Note>
+  Due to Apple's restrictions, downloading your code is only available on the web app.
+</Note>
+
+## Download Your Code
+
+To download your code:
+
+- Open your project in the web app
+- Click the **`<>`** button
+- Click **"Download Code"**
+
+After clicking, the download link will be sent to your email.
+
+{/*
 ## Download Your Code on Mobile
 
 To download your code on the mobile app:
@@ -13,6 +28,7 @@ To download your code on the mobile app:
 - Select "Download Code"
 - Check your email for the download link
 - Download your code
+*/}
 
 ## Use Your Code Anywhere
 
diff --git a/getting-started/sharing-app.mdx b/getting-started/sharing-app.mdx
index 111316e..6d7853e 100644
--- a/getting-started/sharing-app.mdx
+++ b/getting-started/sharing-app.mdx
@@ -5,6 +5,22 @@ description: "Share your Vibecode apps with friends and users"
 
 With Vibecode, you can share your app with anyone without going through the App Store first.
 
+<Note>
+  Due to Apple's restrictions, direct share links are no longer available. To run a Vibecode app on mobile, users need to download the Appsmith app and scan a QR code.
+</Note>
+
+## How to Share Your App
+
+To share your app with someone:
+
+1. Open your project in Vibecode and share the QR code with the person you want to share to
+2. Ask them to download the **Appsmith - Vibecode Apps** app from the [App Store](https://apps.apple.com/us/app/appsmith-vibecode-apps/id6744415724)
+3. Once installed, they can scan the QR code in the Appsmith app to run your Vibecode app
+
+<Tip>
+  Make sure the person you're sharing with has the Appsmith app installed before they try to scan the QR code.
+</Tip>
+
 ## How Sharing Works
 
 To share an app, it must be **published** first. If it is not published yet, Vibecode will prompt you to publish it before sharing.

From c2b9d027ad931dbfa74cc7b06f17de690d278f45 Mon Sep 17 00:00:00 2001
From: Thinal N Pethiyagoda <thinal@sansalabs.co>
Date: Sun, 5 Apr 2026 22:17:01 +0530
Subject: [PATCH 2/3] fix: clarify sharing step to specify web app and Share
 button

---
 getting-started/sharing-app.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/getting-started/sharing-app.mdx b/getting-started/sharing-app.mdx
index 6d7853e..9000245 100644
--- a/getting-started/sharing-app.mdx
+++ b/getting-started/sharing-app.mdx
@@ -13,7 +13,7 @@ With Vibecode, you can share your app with anyone without going through the App
 
 To share your app with someone:
 
-1. Open your project in Vibecode and share the QR code with the person you want to share to
+1. Open your project on the Vibecode web app, click the **Share** button, and share the displayed QR code or link with the person you want to share with
 2. Ask them to download the **Appsmith - Vibecode Apps** app from the [App Store](https://apps.apple.com/us/app/appsmith-vibecode-apps/id6744415724)
 3. Once installed, they can scan the QR code in the Appsmith app to run your Vibecode app
 

From 7e142d1d2b1d5ec77d231f1879586dc1872e881b Mon Sep 17 00:00:00 2001
From: Thinal N Pethiyagoda <thinal@sansalabs.co>
Date: Mon, 6 Apr 2026 03:16:20 +0530
Subject: [PATCH 3/3] docs: fix sharing doc to clarify iOS-only flow and
 comment out old link-sharing sections

---
 getting-started/sharing-app.mdx | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/getting-started/sharing-app.mdx b/getting-started/sharing-app.mdx
index 9000245..26293ff 100644
--- a/getting-started/sharing-app.mdx
+++ b/getting-started/sharing-app.mdx
@@ -6,21 +6,24 @@ description: "Share your Vibecode apps with friends and users"
 With Vibecode, you can share your app with anyone without going through the App Store first.
 
 <Note>
-  Due to Apple's restrictions, direct share links are no longer available. To run a Vibecode app on mobile, users need to download the Appsmith app and scan a QR code.
+  Due to Apple's restrictions, the share functionality is not available on the iOS app. To run a Vibecode app on mobile, users need to download the Appsmith app and scan a QR code.
 </Note>
 
-## How to Share Your App
+## How to Share Your App on iOS
 
-To share your app with someone:
+To share your app with someone on iOS:
 
-1. Open your project on the Vibecode web app, click the **Share** button, and share the displayed QR code or link with the person you want to share with
-2. Ask them to download the **Appsmith - Vibecode Apps** app from the [App Store](https://apps.apple.com/us/app/appsmith-vibecode-apps/id6744415724)
-3. Once installed, they can scan the QR code in the Appsmith app to run your Vibecode app
+1. Open your project on the Vibecode web app
+2. Click the **On Mobile** button in the top right corner of the preview — this opens a popup with a QR code
+3. Share the QR code with the person you want to share with
+4. Ask them to download the **Appsmith - Vibecode Apps** app from the [App Store](https://apps.apple.com/us/app/appsmith-vibecode-apps/id6744415724)
+5. Once installed, they can scan the QR code in the Appsmith app to run your Vibecode app
 
 <Tip>
   Make sure the person you're sharing with has the Appsmith app installed before they try to scan the QR code.
 </Tip>
 
+{/*
 ## How Sharing Works
 
 To share an app, it must be **published** first. If it is not published yet, Vibecode will prompt you to publish it before sharing.
@@ -50,6 +53,7 @@ Open your project, use the **Share** control, and Vibecode will show:
 <Note>
   Sharing a published app is different from App Store distribution. Sharing gives people direct access to the published app link without going through the App Store review process.
 </Note>
+*/}
 
 ## Ready to Go Further?