Flowstride and Flowstride Pro
Flowstride (FS) is the open-source framework on npm. Flowstride Pro is the workspace-connected engine. Flowstride Cloud hosts accounts, workspaces and billing. The Personal plan is free. Team and Business are paid plans. A workspace’s plan determines its features and limits.
Both options run tests on your computer or your CI runner. Cloud adds account-connected features, workspace services, and eligible result review.
Choose the capability you need
| Capability | Flowstride | Flowstride Pro |
|---|---|---|
| Native JS/TS helper calls, fixtures and handoffs | Included | Included |
| Browser and API flows | Included | Included |
| Table/cell targeting, search and assertions | Included | Included |
| Audio input and transcript checks (Chromium) | Included | Included |
| Interactive local dashboard | Included | Included |
| Native CI and browser-game APIs | Included | Included |
| Chromium, Firefox and WebKit | Included | Included |
| Profiles, mocks, downloads and retrying assertions | Included | Included |
| Trace/HAR, accessibility and component workflows | Included | Included |
| Scenario retries and CI file sharding | Included | Included |
| Manual canvas, execution and local run files | Included | Included |
| Parallel execution | Sequential engine | Available within workspace and machine limits |
| FlowMail OTP retrieval | Not available | Available within workspace quotas and service availability |
| Account | Not required for local execution | Free accounts available |
| Cloud reports and evidence | Authenticated integration where eligible | Workspace, plan, and service permissions apply |
Use your workspace's current feature access and limits to confirm what is available. Free accounts include features within their workspace limits; additional features and higher limits depend on the plan.
Start with FS
npm i flowstride
npx flowstride init
npx flowstride runFS does not require a Cloud account for local execution. It includes the local dashboard, manual testing, native CI and browser-game APIs.
Connect Cloud
Create a free Flowstride Cloud account, select your workspace, and create a developer token. After installing your project dependencies, authenticate:
npx flowstride login
npx flowstride statusPaste the developer token into the masked prompt and accept the Flowstride Pro engine installation when offered. Installation uses an authenticated private channel; no separate public package installation is required. Archive integrity and package/path checks run before installation, and failed checks preserve the existing installation. Installation security. Free accounts can use this connection flow too. See Cloud authentication.
Engine selection and fallback
The launcher selects the Flowstride Pro engine when a compatible installation and valid account authorization are available. If the Flowstride Pro engine is missing, incompatible or cannot be authorized, it explains the selection and can fall back to FS.
Read the engine banner at the start of a run. The native browser workflows use the same syntax in both engines. An older Cloud installation that cannot run a requested native workflow triggers an explained FS fallback. Fallback keeps FS capabilities available; account-connected features such as parallel execution and FlowMail require Cloud access within your workspace limits.
Installing project dependencies again may remove the Flowstride Pro engine. If that happens, run npx flowstride login after dependency installation. See installation and updates and authentication troubleshooting.
Where tests run
Tests execute on your computer or your normal CI runner. Cloud provides authenticated workspace services and eligible result review. Connecting a Cloud account does not move test execution away from your chosen machine or CI environment.
