tapflow 0.2.2 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +24 -15
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
1
  <div align="center">
2
2
  <img src="docs/public/logo-hero.svg" height="72" alt="tapflow" />
3
3
 
4
- <h3>Self-hosted iOS & Android simulator streaming for mobile QA</h3>
4
+ <h3>A self-hosted Appetize / BrowserStack alternative for mobile QA teams</h3>
5
5
 
6
6
  <p>
7
- Anyone on your team can run simulators in the browser — no toolchain setup, no device management, no cloud uploads.<br />
7
+ Run iOS simulators and Android emulators in any browser — no toolchain setup, no device management, no cloud uploads.<br />
8
8
  App data never leaves your network.
9
9
  </p>
10
10
 
@@ -24,10 +24,6 @@
24
24
  </p>
25
25
  </div>
26
26
 
27
- ---
28
-
29
- ## Demo
30
-
31
27
  <div align="center">
32
28
  <a href="https://github.com/user-attachments/assets/01914ed2-f35c-4230-ae01-166ffe6af395" target="_blank" rel="noopener noreferrer">
33
29
  <img src="https://raw.githubusercontent.com/jo-duchan/tapflow/main/docs/public/demo-thumbnail.png" alt="tapflow demo — click to play" width="100%" />
@@ -64,15 +60,25 @@ So we built tapflow.
64
60
 
65
61
  ## Features
66
62
 
67
- - **Browser-based** — Anyone on the team needs no installation. Any modern browser works.
68
- - **iOS Simulator** — JPEG frame streaming at ~30 fps via SimulatorKit IOSurface. No WebDriverAgent required.
69
- - **Android Emulator** — H.264 streaming via [scrcpy](https://github.com/Genymobile/scrcpy) at ~30 fps.
70
- - **Touch, swipe & pinch** — real-time input forwarded to the simulator.
71
- - **App Center** — upload `.app.zip` (iOS) or `.apk` (Android), manage builds by status (Backlog / In Progress / Done / Rejected).
72
- - **Session Recordings** — record QA sessions, share with your team. Retained for 72 hours.
73
- - **Mac Resources** — CPU & RAM monitoring per agent. Spot overloaded hosts before assigning sessions.
74
- - **Team management** — invite links, roles (Admin / Developer / QA / Viewer), Personal Access Tokens for CI/CD.
75
- - **Self-hosted** — deploy anywhere. No cloud dependency.
63
+ tapflow focuses on:
64
+
65
+ - **Zero setup for QA** — any browser, no toolchain. Designers, PMs, and server devs test without asking a mobile developer.
66
+ - **Data on-premises** — app binaries and session recordings never leave your network.
67
+ - **Your existing Mac** — no new hardware, no monthly cloud subscription.
68
+ - **API-first** — REST endpoints and PATs built in, ready for CI/CD and AI agent workflows.
69
+
70
+ What's included:
71
+
72
+ - **iOS & Android streaming** — ~30 fps, no additional app required on the device
73
+ - **Touch, swipe & pinch** — real-time input forwarded to the simulator
74
+ - **Deeplink** — jump directly to any screen from the QA toolbar, no manual navigation
75
+ - **Keyboard shortcuts** — simulator toolbar actions without leaving the keyboard
76
+ - **App Center** — upload `.app.zip` / `.apk`, track builds by status (Backlog / In Progress / Done / Rejected)
77
+ - **Session recordings** — record and share QA sessions, retained 72 hours
78
+ - **Screenshot REST endpoint** — `GET /api/v1/sessions/:sessionId/screenshot` for CI and AI agents
79
+ - **Mac resource monitoring** — CPU & RAM per agent, spot overloaded hosts before assigning sessions
80
+ - **Team management** — invite links, roles (Admin / Developer / QA / Viewer), Personal Access Tokens
81
+ - **MCP Server** *(experimental)* — `@tapflowio/mcp-server` lets Claude Code and other LLM agents control simulators as native tools.
76
82
 
77
83
  ## How it works
78
84
 
@@ -201,6 +207,9 @@ Full reference → [CLI docs](https://www.tapflow.dev/reference/cli)
201
207
  - [Configuration](https://www.tapflow.dev/reference/configuration)
202
208
  - [REST API](https://www.tapflow.dev/reference/api)
203
209
 
210
+ **AI Agent**
211
+ - [MCP Server](https://www.tapflow.dev/guide/mcp-server) *(experimental)*
212
+
204
213
  **[Troubleshooting](https://www.tapflow.dev/guide/troubleshooting)**
205
214
 
206
215
  ## Development
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tapflow",
3
- "version": "0.2.2",
3
+ "version": "0.3.1",
4
4
  "description": "Self-hosted iOS/Android simulator streaming for QA teams",
5
5
  "keywords": [
6
6
  "ios",
@@ -46,10 +46,10 @@
46
46
  "cac": "^6.7.14",
47
47
  "ws": "^8.0.0",
48
48
  "zod": "^4.4.3",
49
- "@tapflowio/agent-core": "0.2.2",
50
- "@tapflowio/android-agent": "0.2.2",
51
- "@tapflowio/ios-agent": "0.2.2",
52
- "@tapflowio/relay": "0.2.2"
49
+ "@tapflowio/agent-core": "0.3.1",
50
+ "@tapflowio/android-agent": "0.3.1",
51
+ "@tapflowio/ios-agent": "0.3.1",
52
+ "@tapflowio/relay": "0.3.1"
53
53
  },
54
54
  "devDependencies": {
55
55
  "@types/node": "^20.0.0",