Skip to content

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 ​

CapabilityFlowstrideFlowstride Pro
Native JS/TS helper calls, fixtures and handoffsIncludedIncluded
Browser and API flowsIncludedIncluded
Table/cell targeting, search and assertionsIncludedIncluded
Audio input and transcript checks (Chromium)IncludedIncluded
Interactive local dashboardIncludedIncluded
Native CI and browser-game APIsIncludedIncluded
Chromium, Firefox and WebKitIncludedIncluded
Profiles, mocks, downloads and retrying assertionsIncludedIncluded
Trace/HAR, accessibility and component workflowsIncludedIncluded
Scenario retries and CI file shardingIncludedIncluded
Manual canvas, execution and local run filesIncludedIncluded
Parallel executionSequential engineAvailable within workspace and machine limits
FlowMail OTP retrievalNot availableAvailable within workspace quotas and service availability
AccountNot required for local executionFree accounts available
Cloud reports and evidenceAuthenticated integration where eligibleWorkspace, 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 ​

sh
npm i flowstride
npx flowstride init
npx flowstride run

FS 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:

sh
npx flowstride login
npx flowstride status

Paste 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.

Flowstride is MIT licensed. Flowstride Cloud offers free and paid workspace plans.