vibecode · RikasMRM · Feb 26, 2026 · Feb 27, 2026 · Mar 3, 2026
diff --git a/custom-gpt.mdx b/custom-gpt.mdx
@@ -3,9 +3,7 @@
 description: "Use our Custom GPT to brainstorm and refine your app idea"
 ---
 
-# App Idea Generator
-
 ## Vibecode Custom GPT
 
 Struggling to articulate your app idea? Our custom GPT is designed to help you clarify and refine your vision.

@@ -17,13 +15,24 @@

 1. **Ask Clarifying Questions** - The GPT asks you up to 3 strategic questions about your app idea
 2. **Understand Your Vision** - It learns about your goals, target users, and key features
 3. **Generate the Perfect Prompt** - Based on your answers, it creates a detailed, optimized prompt ready to use in Vibecode

 ## Why Use This?

 - **Save Time** - No more staring at a blank screen trying to figure out what to build
 - **Better Results** - A well-crafted prompt leads to better app generation
 - **Clarify Your Thinking** - The process helps you understand your own idea better
 - **Optimized for Vibecode** - The generated prompt is specifically tailored for Vibecode's AI capabilities
 
 Simply have a conversation with the GPT, and it will produce a prompt you can immediately paste into Vibecode to start building your app!
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Create Your First App" icon="rocket" href="/getting-started/creating-first-app">
+    Take your generated prompt and start building
+  </Card>
+  <Card title="Prompt Templates" icon="copy" href="/getting-started/web-to-mobile">
+    More prompt templates and tips
+  </Card>
+</CardGroup>
diff --git a/deploying/guide.mdx b/deploying/guide.mdx
@@ -1,9 +1,9 @@
 ---
 title: "Deploying Your App"
 description: "Step-by-step guide to deploying your app on Vibecode"
 ---

 You've built something great in Vibecode. Now it's time to share it with the world. This guide walks you through deploying your project so anyone can access it—not just you.

 <CardGroup cols={2}>
  <Card
@@ -24,7 +24,7 @@

 ## What is Deployment?

 When you build an app in Vibecode, it lives inside the Vibecode environment. You can test it, tweak it, and play with it all you want. But if you want other people to use your app—whether that's your friends, your customers, or anyone with your testflight build, your project needs to be **deployed**.

 Think of deployment like publishing a book. Writing the book is one thing, but it needs to go to a printer and get distributed before anyone can read it. Deployment is the "printing and distribution" step for your app.

@@ -34,14 +34,14 @@
  **For both web and mobile apps, the backend is deployed first.** When you hit Deploy, Vibecode builds and publishes your backend server before anything else. This means your API endpoints, database, and authentication are live and ready before your frontend connects to them. For mobile apps, the backend is what gets deployed — the app itself is distributed separately via TestFlight or the App Store.
 </Info>

 ### Why Vibecode Deployments?

 You may have heard of AWS, Railway, Render, or others hosting providers, but they come with trade-offs:

 - **AWS** is powerful but notoriously complex. It's built for engineers with infrastructure experience.
 - **Railway** and **Render** are simpler, but you'll still need to configure environments, manage build pipelines, and troubleshoot on your own.

 Vibecode Deployments is built specifically for apps created on our platform. Everything just works—no configuration headaches, no separate accounts, no DevOps knowledge required. Your app goes live in a few clicks.

 Now, if you're excited to fully launch your project, find out how by following the step-by-step guide with images below!

@@ -144,7 +144,7 @@

 ### Database

 If your app uses Vibecode Cloud for data storage, this tab lets you view and edit your data, which can be big assistance in debugging.

 ### Logs

@@ -161,7 +161,7 @@

 ### Environment

 View and edit your environment variables after deployment. If you need to rotate an API key, add a new integration, or fix a misconfigured secret, this is where you do it.

 ### Analytics (coming soon!)

@@ -177,7 +177,7 @@

 ## Pricing

 Deployment pricing is straightforward and included with your Vibecode subscription:

 | Plan     | Included Deployments |
 | -------- | -------------------- |
@@ -189,7 +189,7 @@

 ## Payment and Billing

 The included deployments with your plan (1 for Plus, 3 for Pro, 5 for Max) are part of your Vibecode subscription. As long as your subscription is active, these deployments stay online at no extra cost.

 ### Adding More Deployments

@@ -235,7 +235,7 @@

 - Check your environment variables for typos or missing values
 - Review the build logs for specific error messages
 - Make sure your app runs correctly inside Vibecode before deploying

 **App not working after deployment?**

@@ -254,3 +254,14 @@
   community](https://discord.gg/qXyWYYX5Ts) to connect with other Vibecode
   builders.
 </Note>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Deploy to App Store" icon="apple" href="/getting-started/deploy-app-store">
+    Publish your mobile app to the App Store
+  </Card>
+  <Card title="Connect a Custom Domain" icon="globe" href="/deploying/custom-domain">
+    Use your own domain name
+  </Card>
+</CardGroup>
diff --git a/deploying/overview.mdx b/deploying/overview.mdx
@@ -0,0 +1,73 @@
+---
+title: "Choose Your Deployment Path"
+description: "Compare deployment options and pick the right one for your app"
+---
+
+Vibecode gives you multiple ways to get your app into users' hands. Here's how to pick the right one.
+
+## Deployment Options at a Glance
+
+| | App Clips | Web Deploy | App Store |
+|---|---|---|---|
+| **Best for** | Sharing with friends, demos, quick testing | Public websites and web apps | Wide distribution on iOS |
+| **Setup time** | Instant | ~2 minutes | 15-30 minutes + Apple review |
+| **Requires** | Any Vibecode plan | Plus plan or above | Plus plan or above + Apple Developer ($99/yr) + Expo account |
+| **How users access** | Tap a link — no install needed | Visit a URL in any browser | Download from the App Store |
+| **Updates** | Automatic | Redeploy in one click | Submit new build + Apple review |
+
+## App Clips — Share Instantly
+
+App Clips let anyone try your app by tapping a link. No download, no App Store. This is the fastest way to share what you've built.
+
+**Use App Clips when:**
+- You want to share your app with friends or testers
+- You're demoing your app
+- You want instant access without friction
+
+<Card title="How to Share via App Clips" icon="share" href="/getting-started/sharing-app">
+  Set up sharing and get your App Clip link
+</Card>
+
+## Web Deploy — Put Your App Online
+
+Deploy your app (or just the backend) to a public URL. Your app gets a `yourapp.vibecode.app` address that works in any browser. You can also connect a custom domain.
+
+**Use Web Deploy when:**
+- You're building a web app or website
+- You need a live backend for your mobile app
+- You want a public URL anyone can visit
+
+<Card title="Web Deployment Guide" icon="globe" href="/deploying/guide">
+  Step-by-step deployment walkthrough
+</Card>
+
+## App Store — Publish to the World
+
+Submit your app to the Apple App Store for anyone to download. Vibecode handles the build process — you just sign in with your Apple Developer credentials and follow the wizard.
+
+**Use App Store when:**
+- You want your app available to the public on iOS
+- You need TestFlight beta testing
+- You're launching a product or business
+
+**Requirements:**
+- [Apple Developer Program](https://developer.apple.com/programs/) membership ($99/year)
+- [Expo account](https://expo.dev/signup) (free)
+- Plus plan or above
+
+<Card title="Deploy to App Store" icon="apple" href="/getting-started/deploy-app-store">
+  Full App Store submission guide
+</Card>
+
+## Not Sure? Start with App Clips
+
+App Clips require no setup, no paid accounts, and work on any plan. Start there, get feedback, and upgrade to Web Deploy or App Store when you're ready.
+
+<CardGroup cols={2}>
+  <Card title="Plans & Credits" icon="credit-card" href="/getting-started/plans-and-credits">
+    Compare plans and features
+  </Card>
+  <Card title="Home Screen Widgets" icon="grid-2" href="/getting-started/home-screen-widgets">
+    Add your app to the home screen
+  </Card>
+</CardGroup>
diff --git a/docs.json b/docs.json
@@ -14,109 +14,53 @@
         "tab": "Getting Started",
         "groups": [
           {
-            "group": "Introduction",
-            "pages": [
-              "index",
-              "getting-started/plans-and-credits",
-              "getting-started/creating-first-app",
-              "getting-started/claude-code",
-              "getting-started/web-app"
-            ]
+            "group": "Welcome",
+            "pages": ["index", "getting-started/plans-and-credits"]
           },
           {
-            "group": "Sharing & Publishing",
-            "pages": [
-              "getting-started/sharing-app",
-              "getting-started/home-screen-widgets",
-              "getting-started/deploy-app-store"
-            ]
+            "group": "Build Your First App",
+            "pages": ["getting-started/creating-first-app"]
+          },
+          {
+            "group": "Building on Web",
+            "pages": ["getting-started/web-app"]
           },
           {
             "group": "Vibecode Tools",
-            "pages": [
-              "getting-started/pinch-to-build",
-              "getting-started/export-ssh",
-              "getting-started/download-code",
-              "getting-started/integrations"
-            ]
+            "pages": ["getting-started/pinch-to-build", "getting-started/export-ssh", "getting-started/download-code"]
           },
           {
-            "group": "Prompting Tips",
-            "pages": [
-              "getting-started/web-to-mobile",
-              "getting-started/native-ui-components"
-            ]
+            "group": "Prompt Templates",
+            "pages": ["getting-started/web-to-mobile", "getting-started/native-ui-components"]
           },
           {
-            "group": "Use Cases",
-            "pages": [
-              "getting-started/use-case-1",
-              "getting-started/use-case-2"
-            ]
+            "group": "Example Projects",
+            "pages": ["getting-started/use-case-1", "getting-started/use-case-2"]
           }
         ]
       },
       {
-        "tab": "Backend & Features",
+        "tab": "Features",
         "groups": [
           {
-            "group": "Backend & Data",
-            "pages": [
-              "features/backend-auth",
-              "features/api-integrations",
-              "features/vibecode-cloud"
-            ]
+            "group": "How It Works",
+            "pages": ["getting-started/claude-code"]
           },
           {
-            "group": "App Capabilities",
-            "pages": [
-              "features/haptics",
-              "features/sound-generation",
-              "features/image-generation"
-            ]
-          }
-        ]
-      },
-      {
-        "tab": "Payments",
-        "groups": [
-          {
-            "group": "Payments",
-            "pages": [
-              "payments/revenuecat-setup",
-              "payments/stripe-setup"
-            ]
-          }
-        ]
-      },
-      {
-        "tab": "Google Login",
-        "groups": [
+            "group": "Backend & Data",
+            "pages": ["features/vibecode-cloud", "features/backend-auth"]
+          },
           {
-            "group": "Google Sign-In (Better Auth)",
-            "pages": [
-              "google-login/setup"
-            ]
-          }
-        ]
-      },
-      {
-        "tab": "Deploying",
-        "groups": [
+            "group": "Authentication",
+            "pages": ["google-login/setup"]
+          },
           {
-            "group": "Web Apps",
-            "pages": [
-              "deploying/guide",
-              "deploying/custom-domain"
-            ]
+            "group": "Monetization",
+            "pages": ["payments/revenuecat-setup", "payments/stripe-setup"]
           },
           {
-            "group": "Mobile Apps",
-            "pages": [
-              "getting-started/sharing-app",
-              "getting-started/home-screen-widgets",
-              "getting-started/deploy-app-store"
-            ]
+            "group": "App Capabilities",
+            "pages": ["features/haptics", "features/sound-generation", "features/image-generation"]
           }
         ]
       },
@@ -125,69 +69,61 @@
         "groups": [
           {
             "group": "Overview",
-            "pages": [
-              "integrations/index"
-            ]
+            "pages": ["integrations/index"]
           },
           {
             "group": "Text Generation",
-            "pages": [
-              "integrations/openai-gpt-5-mini",
-              "integrations/grok-4-fast",
-              "integrations/google-gemini"
-            ]
+            "pages": ["integrations/openai-gpt-5-mini", "integrations/grok-4-fast", "integrations/google-gemini"]
           },
           {
             "group": "Audio",
-            "pages": [
-              "integrations/gpt-4o-audio-transcription",
-              "integrations/elevenlabs-tts",
-              "integrations/elevenlabs-sound-effects",
-              "integrations/elevenlabs-music"
-            ]
+            "pages": ["integrations/gpt-4o-audio-transcription", "integrations/elevenlabs-tts", "integrations/elevenlabs-sound-effects", "integrations/elevenlabs-music"]
           },
           {
             "group": "Image Generation",
-            "pages": [
-              "integrations/openai-gpt-image-1",
-              "integrations/nano-banana",
-              "integrations/ideogram-3"
-            ]
+            "pages": ["integrations/openai-gpt-image-1", "integrations/nano-banana", "integrations/ideogram-3"]
           },
           {
             "group": "Data APIs",
-            "pages": [
-              "integrations/apple-maps",
-              "integrations/tmdb",
-              "integrations/openweather-api",
-              "integrations/stock-market-data",
-              "integrations/crypto-market-data",
-              "integrations/runtime-logs",
-              "integrations/haptic-feedback"
-            ]
+            "pages": ["integrations/apple-maps", "integrations/tmdb", "integrations/openweather-api", "integrations/stock-market-data", "integrations/crypto-market-data", "integrations/runtime-logs", "integrations/haptic-feedback"]
           },
           {
             "group": "Communication",
-            "pages": [
-              "integrations/resend-email",
-              "integrations/expo-push-notifications"
-            ]
+            "pages": ["integrations/resend-email", "integrations/expo-push-notifications"]
+          }
+        ]
+      },
+      {
+        "tab": "Deploying",
+        "groups": [
+          {
+            "group": "Choose Your Path",
+            "pages": ["deploying/overview"]
+          },
+          {
+            "group": "Web Apps",
+            "pages": ["deploying/guide", "deploying/custom-domain"]
+          },
+          {
+            "group": "Mobile Apps",
+            "pages": ["getting-started/sharing-app", "getting-started/home-screen-widgets", "getting-started/deploy-app-store"]
           }
         ]
       },
       {
         "tab": "Resources",
         "groups": [
           {
-            "group": "Resources",
-            "pages": [
-              "custom-gpt",
-              "resources",
-              "updates",
-              "resources/community",
-              "resources/glossary",
-              "support"
-            ]
+            "group": "Help",
+            "pages": ["faqs", "troubleshooting", "support"]
+          },
+          {
+            "group": "Community",
+            "pages": ["resources/community", "custom-gpt"]
+          },
+          {
+            "group": "Reference",
+            "pages": ["resources/glossary", "updates"]
           }
         ]
       }
@@ -277,7 +213,39 @@
     },
     {
       "source": "/features/integrations",
-      "destination": "/getting-started/integrations"
+      "destination": "/integrations/index"
+    },
+    {
+      "source": "/quickstart",
+      "destination": "/getting-started/creating-first-app"
+    },
+    {
+      "source": "/getting-started/integrations",
+      "destination": "/integrations/index"
+    },
+    {
+      "source": "/features/api-integrations",
+      "destination": "/integrations/index"
+    },
+    {
+      "source": "/resources",
+      "destination": "/resources/community"
+    },
+    {
+      "source": "/faq/:slug*",
+      "destination": "/faqs"
+    },
+    {
+      "source": "/google-login/setup-guide",
+      "destination": "/google-login/setup"
+    },
+    {
+      "source": "/google-login/implementation",
+      "destination": "/google-login/setup"
+    },
+    {
+      "source": "/google-login/code-reference",
+      "destination": "/google-login/setup"
     }
   ],
   "footer": {