docs(flutter): migrate FlutterTestingSidebar onto stage + dedicated sidebar

docs/appium-flutter-integration.md

@@ -1,8 +1,9 @@
 ---
 id: appium-flutter-integration
-title: Appium Flutter Integration Driver Testing
-sidebar_label: Flutter Integration Driver
-description: Guide to testing Flutter apps using Appium Flutter Integration Driver on TestMu AI real device cloud.
+title: How to Test Flutter Apps With Appium on TestMu AI
+hide_title: true
+sidebar_label: "Appium Flutter Integration Driver Testing"
+description: Test Flutter apps using the Appium Flutter Integration Driver on TestMu AI real device cloud, across Android and iOS.
 keywords:
   - flutter app testing
   - appium flutter integration
@@ -14,16 +15,17 @@ url: https://www.testmuai.com/support/docs/appium-flutter-integration/
 site_name: TestMu AI
 slug: appium-flutter-integration/
 canonical: https://www.testmuai.com/support/docs/appium-flutter-integration/
+toc_max_heading_level: 2
 ---
 
 import CodeBlock from '@theme/CodeBlock';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import {YOUR_LAMBDATEST_USERNAME, YOUR_LAMBDATEST_ACCESS_KEY} from "@site/src/component/keys";
-import RealDeviceTag from '../src/component/realDevice';
-import VirtualDeviceTag from '../src/component/virtualDevice';
 
 import BrandName, { BRAND_URL } from '@site/src/component/BrandName';
+import RealDeviceTag from '@site/src/component/realDevice';
+import VirtualDeviceTag from '@site/src/component/virtualDevice';
 import VerifiedTag from '@site/src/component/verifiedTag';
 
 <script type="application/ld+json"
@@ -61,7 +63,7 @@ import VerifiedTag from '@site/src/component/verifiedTag';
       "@type": "WebPage",
       "@id": "https://www.testmuai.com/support/docs/appium-flutter-integration/"
     },
-    "headline": "Appium Flutter Integration Driver Testing",
+    "headline": "How to Test Flutter Apps With Appium on TestMu AI",
     "description": "Guide to testing Flutter apps using Appium Flutter Integration Driver on TestMu AI real device cloud.",
     "url": "https://www.testmuai.com/support/docs/appium-flutter-integration/",
     "image": {
@@ -131,12 +133,18 @@ import VerifiedTag from '@site/src/component/verifiedTag';
   }) }}
 />
 
+
 <RealDeviceTag value="Real Device" /> <VirtualDeviceTag value="Virtual Device" />
+
+# How to Test Flutter Apps With Appium on TestMu AI
+
+Testing Flutter apps on TestMu AI with Appium Flutter Integration Driver automates Flutter UI validation on real Android and iOS devices in the cloud, letting you write tests in multiple languages, switch contexts seamlessly, and drive gestures beyond native limits.
+
 <BrandName /> supports testing Flutter applications on real Android and iOS devices using the [**Appium Flutter Integration Driver**](https://github.com/AppiumTestDistribution/appium-flutter-integration-driver/). This driver enables you to automate End-to-End (E2E) testing of Flutter apps in multiple programming languages, providing a powerful and flexible way to validate your Flutter apps on real devices in the cloud.
 
 Testing Flutter apps requires embedding the **Flutter Integration Server** inside your app to enable communication between Appium and Flutter UI elements.
 
-After preparing your Flutter app with this integration (refer to the setup documentation below), you can build, upload, and execute your tests on <BrandName /> real devices using the Appium Flutter Integration Driver.
+After preparing your Flutter app with this integration, you can build, upload, and execute your tests on <BrandName /> real devices using the Appium Flutter Integration Driver.
 
 ---
 
@@ -213,7 +221,6 @@ void main() {
 
 <Tabs>
   <TabItem value="android" label="Android" default>
-
     <VerifiedTag value="Verified" />
 
     <CodeBlock className="language-bash">
@@ -222,7 +229,6 @@ void main() {
   </TabItem>
 
   <TabItem value="ios-simulator" label="iOS Simulator">
-
     <VerifiedTag value="Verified" />
 
     <CodeBlock className="language-bash">
@@ -231,7 +237,6 @@ void main() {
   </TabItem>
 
   <TabItem value="ios-device" label="iOS Real Device">
-
     <VerifiedTag value="Verified" />
 
     <CodeBlock className="language-bash">
@@ -247,18 +252,17 @@ void main() {
 
 
 - For detailed instructions on how to upload your application to <BrandName />, please refer to our comprehensive guide.
-- Visit the [**Upload your Application**](/support/docs/application-setup-via-api/#upload-your-application) documentation to learn more.
+- Visit the [**Upload your Application**](/support/docs/application-setup-via-api/#upload-via-the-rest-api) documentation to learn more.
 - Use the returned **App ID** from above step in your automation scripts.
 
 
 
 ---
 
-## Sample Desired Capabilities <RealDeviceTag value="Real Device" /> <VirtualDeviceTag value="Virtual Device" />
+## Sample Desired Capabilities Real &amp; Virtual
 
 <Tabs>
   <TabItem value="android" label="Android" default>
-
     <VerifiedTag value="Verified" />
 
     <CodeBlock className="language-java">
@@ -278,7 +282,6 @@ void main() {
   </TabItem>
 
   <TabItem value="ios" label="iOS">
-
     <VerifiedTag value="Verified" />
 
     <CodeBlock className="language-java">

docs/flutter-agent-skills.md

@@ -0,0 +1,203 @@
+---
+id: flutter-agent-skills
+title: How to Run Flutter Tests With Agent Skills on TestMu AI
+toc_max_heading_level: 2
+hide_title: true
+sidebar_label: "Run Tests With Agent Skills"
+description: Run Flutter tests using AI agent skills on TestMu AI. Generate and execute Flutter and Dart mobile automation on real devices from natural-language prompts.
+keywords:
+  - flutter agent skills
+  - ai flutter test automation
+  - flutter ai coding
+  - agent skills flutter
+  - testmu ai agent skills
+  - flutter real device ai
+image: /assets/images/og-images/automation-testing-og.png
+url: https://www.testmuai.com/support/docs/flutter-agent-skills/
+site_name: TestMu AI
+slug: flutter-agent-skills/
+canonical: https://www.testmuai.com/support/docs/flutter-agent-skills/
+---
+
+import BrandName, { BRAND_URL } from '@site/src/component/BrandName';
+
+<script type="application/ld+json"
+      dangerouslySetInnerHTML={{ __html: JSON.stringify({
+       "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        "itemListElement": [{
+          "@type": "ListItem",
+          "position": 1,
+          "name": "TestMu AI",
+          "item": BRAND_URL
+        },{
+          "@type": "ListItem",
+          "position": 2,
+          "name": "Support",
+          "item": `${BRAND_URL}/support/docs/`
+        },{
+          "@type": "ListItem",
+          "position": 3,
+          "name": "How to Run Flutter Tests With Agent Skills on TestMu AI",
+          "item": `${BRAND_URL}/support/docs/flutter-agent-skills/`
+        }]
+    })
+  }}
+></script>
+
+# How to Run Flutter Tests With Agent Skills on TestMu AI
+---
+
+
+Flutter Agent Skills on <BrandName /> let your AI coding assistant generate production-ready Flutter and Dart mobile automation from natural-language prompts. The flutter-skill package teaches assistants correct project structure, Dart dependencies, and driver configuration, then runs tests on real devices.
+
+Instead of manually wiring up your Flutter test project, use **Agent Skills** to let your AI coding assistant generate production-ready Flutter and Dart mobile automation for you. The [flutter-skill](https://github.com/LambdaTest/agent-skills/tree/main/flutter-skill) is part of [TestMu AI Agent Skills](https://github.com/LambdaTest/agent-skills/) - structured packages that teach AI assistants how to write production-grade test code and run it on real devices.
+
+## What Agent Skills Are
+---
+
+Self-contained packages of instructions, code patterns, and configurations for a specific testing framework.
+
+Once installed, your AI assistant works like a senior mobile QA automation architect with knowledge of:
+
+- Proper Flutter integration test and Appium Flutter driver project structure
+- Correct Dart dependencies and driver configuration
+- Both local and TestMu AI real-device cloud execution patterns
+- Common pitfalls and debugging approaches
+- CI/CD integration with GitHub Actions
+
+## Prerequisites
+---
+
+Make sure you have the following set up before you start.
+
+1. [Create a TestMu AI account](https://www.testmuai.com/register/) if you don't have one.
+2. Get your **Username** and **Access Key** from the [TestMu AI Dashboard](https://www.testmuai.com/login/?redirectTo=https://accounts.lambdatest.com/dashboard).
+3. Install an AI coding assistant: [Claude Code](https://claude.ai/code), [GitHub Copilot](https://github.com/features/copilot), [Cursor](https://cursor.sh/), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or any compatible tool.
+
+## Step 1: Install the Flutter Agent Skill
+---
+
+Clone the repository and copy the Flutter skill into your AI tool's skills directory.
+
+```bash
+git clone https://github.com/LambdaTest/agent-skills.git
+
+# For Claude Code
+cp -r agent-skills/flutter-skill .claude/skills/
+
+# For Cursor
+cp -r agent-skills/flutter-skill .cursor/skills/
+
+# For GitHub Copilot
+cp -r agent-skills/flutter-skill .github/skills/
+
+# For Gemini CLI
+cp -r agent-skills/flutter-skill .gemini/skills/
+```
+
+:::tip
+Install **all available framework skills** at once by cloning the repository directly into your tool's skills directory (e.g., `.claude/skills/`, `.cursor/skills/`).
+:::
+
+## Step 2: Set Your Credentials
+---
+
+Add your TestMu AI credentials as environment variables so the generated tests can authenticate with the real device cloud.
+
+Visit the [TestMu AI Dashboard](https://www.testmuai.com/login/?redirectTo=https://accounts.lambdatest.com/dashboard), navigate to the left sidebar, and select **Credentials**. Copy your **Username** and **Access Key**, then run:
+
+```bash
+export LT_USERNAME="YOUR_LAMBDATEST_USERNAME"
+export LT_ACCESS_KEY="YOUR_LAMBDATEST_ACCESS_KEY"
+```
+
+## Step 3: Run Your First Test
+---
+
+Ask your AI assistant to write tests in natural language.
+
+```
+"Write a Flutter integration test for my app's login screen and run it on TestMu AI real devices"
+```
+
+```
+"Set up an Appium Flutter driver project in Dart and run it on TestMu AI"
+```
+
+```
+"Run my Flutter test across a Pixel 7 and an iPhone 15 in parallel on TestMu AI, tag the build as 'release-v1.0'"
+```
+
+The Agent Skill automatically handles:
+
+1. **Project setup** - Creates the right Flutter/Dart dependencies, driver configuration, and project structure
+2. **Approach detection** - Maps your request to Flutter integration tests or the Appium Flutter driver
+3. **Execution target** - Configures local, real-device, or virtual-device execution on TestMu AI based on your request
+4. **Best practices** - Uses stable finders, proper waits, and reliable synchronization patterns
+
+## What's Included in the Flutter Skill
+---
+
+A breakdown of everything the skill package contains.
+
+```
+flutter-skill/
+├── SKILL.md
+└── reference/
+    ├── playbook.md
+    └── advanced-patterns.md
+```
+
+| Section | Details |
+|---------|---------|
+| **Project Setup** | Dart dependencies, driver configuration, project structure |
+| **Core Patterns** | Complete, runnable code examples with best practices |
+| **Cloud Integration** | TestMu AI real-device capabilities and app-upload configuration |
+| **CI/CD Integration** | GitHub Actions workflows with reporting and parallel execution |
+| **Debugging Guide** | Common build and driver errors mapped to solutions |
+| **Best Practices** | Actionable recommendations for production Flutter test code |
+
+## Supported AI Tools
+---
+
+Pick the tool you use and install the skill to the corresponding path.
+
+| Tool | Type | Installation Path |
+|------|------|-------------------|
+| Claude Code | CLI | `.claude/skills/` |
+| GitHub Copilot | Extension | `.github/skills/` |
+| Cursor | IDE | `.cursor/skills/` |
+| Gemini CLI | CLI | `.gemini/skills/` |
+| Codex CLI | CLI | `.codex/skills/` |
+| OpenCode | CLI | `.opencode/skills/` |
+| Claude.ai | Web | Settings > Features > Skills |
+
+## Next Steps
+---
+
+Continue with these related guides:
+
+- [Run Your First Flutter Test](/support/docs/testing-flutter-apps/)
+- [Flutter Supported Capabilities](/support/docs/flutter-supported-capabilities/)
+- [Appium Flutter Integration Driver Testing](/support/docs/appium-flutter-integration/)
+
+<nav aria-label="breadcrumbs">
+  <ul className="breadcrumbs">
+    <li className="breadcrumbs__item">
+      <a className="breadcrumbs__link" target="_self" href={BRAND_URL}>
+        Home
+      </a>
+    </li>
+    <li className="breadcrumbs__item">
+      <a className="breadcrumbs__link" target="_self" href={`${BRAND_URL}/support/docs/`}>
+        Support
+      </a>
+    </li>
+    <li className="breadcrumbs__item breadcrumbs__item--active">
+      <span className="breadcrumbs__link">
+        How to Run Flutter Tests With Agent Skills on TestMu AI
+      </span>
+    </li>
+  </ul>
+</nav>

docs/flutter-supported-capabilities.md

@@ -1,6 +1,6 @@
 ---
 id: flutter-supported-capabilities
-title: Flutter Supported Capabilities
+title: Flutter Supported Capabilities on TestMu AI
 sidebar_label: Supported Capabilities
 description: Now you can run your Flutter framework on TestMu AI online grid of 3000+ real desktop browsers and real operating systems with its supported capabilities.
 keywords:
@@ -15,6 +15,7 @@ url: https://www.testmuai.com/support/docs/flutter-supported-capabilities/
 site_name: TestMu AI
 slug: flutter-supported-capabilities/
 canonical: https://www.testmuai.com/support/docs/flutter-supported-capabilities/
+toc_max_heading_level: 2
 ---
 
 import CodeBlock from '@theme/CodeBlock';
@@ -39,7 +40,7 @@ import BrandName, { BRAND_URL } from '@site/src/component/BrandName';
         },{
           "@type": "ListItem",
           "position": 3,
-          "name": "Espresso Supported Capabilities",
+          "name": "Flutter Supported Capabilities on TestMu AI",
           "item": `${BRAND_URL}/support/docs/flutter-supported-capabilities/`
         }]
       })
@@ -57,7 +58,7 @@ import BrandName, { BRAND_URL } from '@site/src/component/BrandName';
       "@type": "WebPage",
       "@id": "https://www.testmuai.com/support/docs/flutter-supported-capabilities/"
     },
-    "headline": "Flutter Supported Capabilities",
+    "headline": "Flutter Supported Capabilities on TestMu AI",
     "description": "Now you can run your Flutter framework on TestMu AI online grid of 3000+ real desktop browsers and real operating systems with its supported capabilities.",
     "url": "https://www.testmuai.com/support/docs/flutter-supported-capabilities/",
     "image": {
@@ -103,7 +104,7 @@ import BrandName, { BRAND_URL } from '@site/src/component/BrandName';
   }) }}
 />
 
-This document provide details about the features and capabilities supported for Espresso Framework on <BrandName />.
+Flutter supported capabilities on TestMu AI let you configure Flutter mobile app tests on real Android devices, controlling the app, test suite, device, video, timeouts, device logs, build name, permissions, geolocation, GPS coordinates, and Bluetooth for reliable end-to-end automation runs.
 
 | Capability Name | Data Type | Description |
 |------|-----------|-------------|