Restructure examples documentation (#3040)

Changed example location to include `templates` and `apps` as discussed.
    
<!-- This is an auto-generated description by cubic. -->
---

## Summary by cubic
Restructures the Examples docs into a top-level section with Templates
and Apps. Adds two app examples (Ad Generator and QA-Testing) and moves
the Prompting Guide under Customize > Agent.

- **Refactors**
- Moved examples from customize/examples/* to examples/templates/* (no
content changes).
- Added new top-level Examples group in docs.json with Templates and
Apps; removed old Examples under Customize.
- Relocated Prompting Guide to customize/agent/prompting-guide and added
it to navigation.

- **Migration**
  - Update links from customize/examples/* to examples/templates/*.
  - Update links to prompting-guide to customize/agent/prompting-guide.

<!-- End of auto-generated description by cubic. -->

Author: MagMueller

docs/customize/examples/prompting-guide.mdx renamed to docs/customize/agent/prompting-guide.mdx

@@ -74,6 +74,42 @@
     {
       "source": "/customize/examples/chain-agents",
       "destination": "/customize/examples/follow-up-tasks"
+    },
+    {
+      "source": "/customize/examples/fast-agent",
+      "destination": "/examples/templates/fast-agent"
+    },
+    {
+      "source": "/customize/examples/follow-up-tasks",
+      "destination": "/examples/templates/follow-up-tasks"
+    },
+    {
+      "source": "/customize/examples/parallel-browser",
+      "destination": "/examples/templates/parallel-browser"
+    },
+    {
+      "source": "/customize/examples/playwright-integration",
+      "destination": "/examples/templates/playwright-integration"
+    },
+    {
+      "source": "/customize/examples/sensitive-data",
+      "destination": "/examples/templates/sensitive-data"
+    },
+    {
+      "source": "/customize/examples/secure",
+      "destination": "/examples/templates/secure"
+    },
+    {
+      "source": "/customize/examples/more-examples",
+      "destination": "/examples/templates/more-examples"
+    },
+    {
+      "source": "/customize/examples/ad-use",
+      "destination": "/examples/apps/ad-use"
+    },
+    {
+      "source": "/customize/examples/vibetest-use",
+      "destination": "/examples/apps/vibetest-use"
     }
   ],
   "navigation": {
@@ -99,6 +135,7 @@
                 "pages": [
                   "customize/agent/basics",
                   "customize/agent/supported-models",
+                  "customize/agent/prompting-guide",
                   "customize/agent/output-format",
                   "customize/agent/all-parameters"
                 ]
@@ -126,20 +163,6 @@
                   "customize/tools/response"
                 ]
               },
-              {
-                "group": "Examples",
-                "icon": "folder-open",
-                "pages": [
-                  "customize/examples/fast-agent",
-                  "customize/examples/follow-up-tasks",
-                  "customize/examples/parallel-browser",
-                  "customize/examples/playwright-integration",
-                  "customize/examples/sensitive-data",
-                  "customize/examples/secure",
-                  "customize/examples/more-examples",
-                  "customize/examples/prompting-guide"
-                ]
-              },
               {
                 "group": "Integration",
                 "icon": "plug",
@@ -150,6 +173,32 @@
               }
             ]
           },
+          {
+            "group": "Examples",
+            "pages": [
+              {
+                "group": "Templates",
+                "icon": "folder",
+                "pages": [
+                  "examples/templates/fast-agent",
+                  "examples/templates/follow-up-tasks",
+                  "examples/templates/parallel-browser",
+                  "examples/templates/playwright-integration",
+                  "examples/templates/sensitive-data",
+                  "examples/templates/secure",
+                  "examples/templates/more-examples"
+                ]
+              },
+              {
+                "group": "Apps",
+                "icon": "box-open",
+                "pages": [
+                  "examples/apps/ad-use",
+                  "examples/apps/vibetest-use"
+                ]
+              }
+            ]
+          },
           {
             "group": "Development",
             "pages": [

docs/docs.json

@@ -0,0 +1,71 @@
+---
+title: "Ad-Use (Ad Generator)"
+description: "Generate Instagram ads from landing pages using browser agents and Google's Nano Banana 🍌."
+icon: "image"
+mode: "wide"
+---
+
+<Note>
+This demo requires browser-use v0.7.6+.
+</Note>
+
+<video
+  controls
+  className="w-full aspect-video rounded-xl"
+  src="https://github.com/user-attachments/assets/7fab54a9-b36b-4fba-ab98-a438f2b86b7e">
+</video>
+
+## Features
+
+1. Agent visits your target website
+2. Captures brand name, tagline, and key selling points
+3. Takes a clean screenshot for design reference
+4. Creates a scroll-stopping Instagram ad with 🍌
+
+## Setup
+
+Make sure the newest version of browser-use is installed (with screenshot functionality):
+```bash
+pip install -U browser-use
+```
+
+Export your Gemini API key, get it from: [Google AI Studio](https://makersuite.google.com/app/apikey) 
+```
+export GOOGLE_API_KEY='your-google-api-key-here'
+```
+
+## Normal Usage
+
+```bash
+# Basic - Generate ad from any website
+python ad_generator.py https://www.apple.com/iphone-16-pro/
+
+# Debug Mode - See the browser in action
+python ad_generator.py https://www.apple.com/iphone-16-pro/ --debug
+```
+
+## Programmatic Usage
+```python
+import asyncio
+from ad_generator import create_ad_from_landing_page
+
+async def main():
+    results = await create_ad_from_landing_page(
+        url="https://your-landing-page.com",
+        debug=False
+    )
+    print(f"Generated ads: {results}")
+
+asyncio.run(main())
+```
+
+## Output
+
+Generated ads are saved in the `output/` directory with:
+- **PNG image files** (ad_style_timestamp.png) - Actual generated ads from Gemini 2.5 Flash Image
+- **Prompt files** (ad_style_timestamp_prompt.txt) - The prompts used for generation  
+- **Landing page screenshots** for reference
+
+## Source Code
+
+Full implementation: [https://github.com/browser-use/browser-use/tree/main/examples/apps/ad-use](https://github.com/browser-use/browser-use/tree/main/examples/apps/ad-use)

docs/examples/apps/ad-use.mdx

@@ -0,0 +1,90 @@
+---
+title: "Vibetest-Use (Automated QA)"
+description: "Run multi-agent Browser-Use tests to catch UI bugs, broken links, and accessibility issues before they ship."
+icon: "bug"
+mode: "wide"
+---
+
+<Note>
+Requires **browser-use&nbsp; < v0.5.0** and Playwright Chromium. Currently getting an update to v0.7.6+. 
+</Note>
+
+<video
+  controls
+  className="w-full aspect-video rounded-xl"
+  src="https://github.com/user-attachments/assets/6450b5b7-10e5-4019-82a4-6d726dbfbe1f">
+</video>
+
+## Features
+
+1. Launches multiple headless (or visible) Browser-Use agents in parallel
+2. Crawls your site and records screenshots, broken links & a11y issues
+3. Works on production URLs *and* `localhost` dev servers
+4. Simple natural-language prompts via MCP in Cursor / Claude Code
+
+## Quick Start
+
+```bash
+# 1.  Create & activate env
+uv venv --python 3.11
+source .venv/bin/activate
+
+# 2.  Install project
+uv pip install -e .
+
+# 3.  Install browser runtime once
+playwright install chromium --with-deps --no-shell
+```
+
+### 1) Claude Code
+
+```bash
+# Register the MCP server
+claude mcp add vibetest /full/path/to/vibetest-use/.venv/bin/vibetest-mcp \
+  -e GOOGLE_API_KEY="your_api_key"
+
+# Inside a Claude chat
+> /mcp
+# ⎿  MCP Server Status
+#    • vibetest: connected
+```
+
+### 2) Cursor (manual MCP entry)
+
+1. Open **Settings → MCP**  
+2. Click **Add Server** and paste:
+
+```json
+{
+  "mcpServers": {
+    "vibetest": {
+      "command": "/full/path/to/vibetest-use/.venv/bin/vibetest-mcp",
+      "env": {
+        "GOOGLE_API_KEY": "your_api_key"
+      }
+    }
+  }
+}
+```
+
+## Basic Prompts
+```
+> Vibetest my website with 5 agents: browser-use.com
+> Run vibetest on localhost:3000
+> Run a headless vibetest on localhost:8080 with 10 agents
+```
+
+### Parameters
+* **URL** – any `https` or `http` host or `localhost:port`
+* **Agents** – `3` by default; more agents = deeper coverage
+* **Headless** – say *headless* to hide the browser, omit to watch it live
+
+## Requirements
+
+* Python 3.11+
+* Google API key (Gemini flash used for analysis)
+* Cursor / Claude with MCP support
+
+## Source Code
+
+Full implementation: [https://github.com/browser-use/vibetest-use](https://github.com/browser-use/vibetest-use)