Skip to content

Start with a workflow ​

Flowstride (FS) lets you write browser and API tests in readable .flow files, inspect a run in a local dashboard, and run the same suite in CI. The Manual Workspace helps you design and carry out tests that still need a person.

Choose a starting point:

I want to…Start here
Run a browser and API testFirst automated flow
Design a test without writing automationFirst manual flow
Run existing tests on GitHubNative CI
Search a table or act on a specific cellTable and cell testing
Verify speech-to-text in an applicationAudio-to-text testing
Test a browser gameGame testing
Write a loop, calculate discounts or check every item in a UIComplex tests with JS and TS
Make a test wait for an account created by another testFixtures and handoffs
Connect a Cloud accountFlowstride and Flowstride Pro
Combine API setup with browser loginAPI and UI in one flow
Use separate users, mocks or downloadsNative browser workflows

Install the public engine ​

Use Node.js 22.12 or newer and an npm project. In a new folder:

sh
npm init -y
npm install --save-dev flowstride
npx flowstride init
npx flowstride run

init scaffolds the starter and advanced examples and checks for matching Chromium binaries. Plain npx flowstride run starts the bundled application on localhost and opens the live dashboard. The starter browses the catalog and signs in with a seeded account.

In an existing Flowstride project, use npx flowstride init --practice and run from .flowstride/practice. The practice app supplies its own URL and runs offline once the package and browser are installed. Practice and advanced examples

Set BASE_URL in the project-root .env for tests against your own application. With your own application running, pass its flow path to the CLI. Your first automated flow

Connect a Cloud account ​

FS runs locally without an account. Cloud includes free accounts and additional features within your workspace limits. Create a Cloud account and developer token, then run:

sh
npx flowstride login
npx flowstride status

Authenticate with a developer token and accept the Flowstride Pro engine installation when offered. See Flowstride and Flowstride Pro for engine selection and fallback.

Run, inspect, repeat ​

sh
npx flowstride run
npx flowstride run --ci
npx flowstride open

The first command opens the interactive automation dashboard. The second runs without a dashboard and writes CI reports. The third opens the separate Manual Workspace. Follow the localhost URL printed in the terminal; ports are allocated dynamically.

You can use FS without a Cloud account, or connect a free Cloud account. Cloud features and usage limits depend on the workspace plan; the Flowstride Pro engine is installed through an authenticated private channel. Learn how selection and fallback work.

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