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 test | First automated flow |
| Design a test without writing automation | First manual flow |
| Run existing tests on GitHub | Native CI |
| Search a table or act on a specific cell | Table and cell testing |
| Verify speech-to-text in an application | Audio-to-text testing |
| Test a browser game | Game testing |
| Write a loop, calculate discounts or check every item in a UI | Complex tests with JS and TS |
| Make a test wait for an account created by another test | Fixtures and handoffs |
| Connect a Cloud account | Flowstride and Flowstride Pro |
| Combine API setup with browser login | API and UI in one flow |
| Use separate users, mocks or downloads | Native browser workflows |
Install the public engine
Use Node.js 22.12 or newer and an npm project. In a new folder:
npm init -y
npm install --save-dev flowstride
npx flowstride init
npx flowstride runinit 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:
npx flowstride login
npx flowstride statusAuthenticate 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
npx flowstride run
npx flowstride run --ci
npx flowstride openThe 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.
