flutter-skill 0.8.3 → 0.8.5

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://github.com/ai-dashboad/flutter-skill">
-    <img src="assets/demo-teaser.gif" alt="AI testing a TikTok clone across 8 platforms" width="640">
+    <img src="assets/demo-teaser.gif" alt="AI testing a TikTok clone across 10 platforms" width="640">
   </a>
 </p>
 
@@ -8,7 +8,7 @@
 
 <p align="center">
   <strong>Give any AI agent eyes and hands inside any running app.</strong><br>
-  8 platforms. Zero test code. One MCP server.
+  10 platforms. Zero test code. One MCP server.
 </p>
 
 <p align="center">
@@ -22,11 +22,15 @@
 <p align="center">
   <a href="#30-second-demo">Demo</a> •
   <a href="#quick-start">Quick Start</a> •
-  <a href="#8-platforms-one-tool">Platforms</a> •
+  <a href="#10-platforms-one-tool">Platforms</a> •
   <a href="#why-not-playwright--appium--detox">vs Others</a> •
   <a href="docs/USAGE_GUIDE.md">Docs</a>
 </p>
 
+<p align="center"><b>🚀 Zero config. Zero test code. Just talk to your AI.</b></p>
+
+<p align="center"><sub>If this saves you time, please consider <a href="https://github.com/ai-dashboad/flutter-skill/stargazers">starring the repo ⭐</a> — it helps others find it!</sub></p>
+
 ---
 
 ## 30-Second Demo
@@ -39,9 +43,12 @@ https://github.com/user-attachments/assets/d4617c73-043f-424c-9a9a-1a61d4c2d3c6
 
 ## Why This Exists
 
-Writing E2E tests is painful. Maintaining them is worse.
+Writing E2E tests is painful. Maintaining them is worse. **flutter-skill** takes a different approach:
 
-**flutter-skill** connects your AI agent (Claude, Cursor, Windsurf, Copilot, OpenClaw) directly to your running app via [MCP](https://modelcontextprotocol.io/). The agent can see the screen, tap buttons, type text, scroll — like a human tester who never sleeps.
+- 🔌 **Connects any AI agent** (Claude, Cursor, Windsurf, Copilot, OpenClaw) directly to your running app via [MCP](https://modelcontextprotocol.io/)
+- 👀 **The agent sees your screen** — taps buttons, types text, scrolls, navigates — like a human tester who never sleeps
+- ✅ **Zero test code** — no Page Objects, no XPath, no brittle selectors. Just plain English
+- ⚡ **Zero config** — 2 lines of code, works on all 10 platforms
 
 ```
 You: "Test the checkout flow with an empty cart, then add 3 items and complete purchase"
@@ -90,7 +97,7 @@ void main() {
 
 > *"Launch my app, explore every screen, and report any bugs"*
 
-That's it. **Zero configuration. Zero test code.**
+That's it. **Zero configuration. Zero test code. Works in under 60 seconds.**
 
 <details>
 <summary>📦 More install methods (Homebrew, Scoop, Docker, IDE, Agent Skill)</summary>
@@ -111,9 +118,9 @@ That's it. **Zero configuration. Zero test code.**
 
 ---
 
-## 8 Platforms, One Tool
+## 10 Platforms, One Tool
 
-Most testing tools work on 1-2 platforms. flutter-skill works on **8**.
+Most testing tools work on 1-2 platforms. flutter-skill works on **10**.
 
 | Platform | SDK | Test Score |
 |----------|-----|:----------:|
@@ -125,11 +132,33 @@ Most testing tools work on 1-2 platforms. flutter-skill works on **8**.
 | **KMP Desktop** | [`sdks/kmp`](sdks/kmp/) | ✅ 75/75 |
 | **.NET MAUI** | [`sdks/dotnet-maui`](sdks/dotnet-maui/) | ✅ 75/75 |
 | **iOS** (Swift/UIKit) | [`sdks/ios`](sdks/ios/) | ✅ 19/19 |
+| **Web** (any website) | [`sdks/web`](sdks/web/) | ✅ |
+| **Web CDP** (zero-config) | No SDK needed | ✅ 141/156 |
 
 **Total: 656/664 tests passing (98.8%)** — each platform tested against a complex social media app with 50+ elements.
 
 ---
 
+## ⚡ Performance
+
+Real benchmarks from automated test runs against a complex social media app:
+
+| Operation | Web (CDP) | Electron | Android |
+|-----------|:---------:|:--------:|:-------:|
+| `connect` | 93 ms | 55 ms | 103 ms |
+| `tap` | **1 ms** | **1 ms** | **2 ms** |
+| `enter_text` | **1 ms** | **1 ms** | **2 ms** |
+| `inspect` | 3 ms | 12 ms | 10 ms |
+| `snapshot` | **2 ms** | **8 ms** | **29 ms** |
+| `screenshot` | **31 ms** | **80 ms** | **88 ms** |
+| `eval` | **1 ms** | — | — |
+
+**Token efficiency:** `snapshot()` returns a structured element tree instead of an image — **87–99% fewer tokens** than sending screenshots to your AI agent.
+
+**How fast is that?** A `tap` takes 1–2 ms end-to-end. Browser automation tools like Playwright and Selenium typically take 50–100 ms for the same operation. That's 50–100× faster, because flutter-skill talks directly to the app runtime instead of going through WebDriver or CDP indirection.
+
+---
+
 ## Why Not Playwright / Appium / Detox?
 
 | | flutter-skill | Playwright | Appium | Detox |
@@ -137,7 +166,7 @@ Most testing tools work on 1-2 platforms. flutter-skill works on **8**.
 | **Setup time** | 30 sec | Minutes | Hours | Hours |
 | **Test code needed** | ❌ None | ✅ Yes | ✅ Yes | ✅ Yes |
 | **AI-native (MCP)** | ✅ | ❌ | ❌ | ❌ |
-| **Platforms** | 8 | 3 (web) | Mobile | React Native |
+| **Platforms** | 10 | 3 (web) | Mobile | React Native |
 | **Natural language** | ✅ | ❌ | ❌ | ❌ |
 | **Maintenance** | Zero | High | High | Medium |
 | **Flutter support** | ✅ Native | Partial | Partial | ❌ |
@@ -193,7 +222,7 @@ Most testing tools work on 1-2 platforms. flutter-skill works on **8**.
 </table>
 
 <details>
-<summary><strong>40+ tools — full reference</strong></summary>
+<summary><strong>160+ tools — full reference</strong></summary>
 
 **Launch & Connect:** `launch_app`, `scan_and_connect`, `hot_reload`, `hot_restart`, `list_sessions`, `switch_session`, `close_session`
 

package/dart/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_skill_npm
 description: Give your AI Agent eyes and hands inside your Flutter app.
-version: 0.2.0
+version: 0.8.5
 publish_to: 'none'
 homepage: https://github.com/ai-dashboad/flutter-skill
 repository: https://github.com/ai-dashboad/flutter-skill

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "flutter-skill",
   "mcpName": "io.github.ai-dashboad/flutter-skill",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "MCP Server for app automation - Give your AI Agent eyes and hands inside any app (Flutter, React, Web, Native)",
   "main": "index.js",
   "bin": {