Installation and updates
Install Flowstride (FS) in the project that contains your tests. Use Node.js 22.12 or newer.
Install Flowstride
npm install --save-dev flowstride
npx flowstride initThe public npm package runs locally without an account. In a fresh project, init creates the local practice app configuration, example flows and JS/TS helper directory, then checks Chromium. Run npx flowstride run to open the live dashboard.
If Chromium setup failed, install the matching browser explicitly:
npx flowstride installTo use additional engines:
npx flowstride install chromium firefox webkit
npx flowstride run --browser firefoxKeep the package and its matching browsers together when updating your project. Browser compatibility explains headed runs, dashboard windows and engine limits.
Bring the practice examples into an existing project
After updating your dependency, run npx flowstride --version in the project root. To try the new examples alongside your own suite, run npx flowstride init --practice. In an existing FS project this creates a separate practice workspace under .flowstride/practice. Change into that directory and run npx flowstride run. For the pricing and role-assignment examples, see the practice walkthrough.
Existing SDK plugins keep their alias syntax. You can add a named JS/TS helper to one scenario at a time. The CLI command is still flowstride and scenarios still use .flow. Calling helpers
Keep project installs reproducible
Commit package.json and package-lock.json. Use npm ci in CI to install the dependencies selected by that lockfile.
npm ci
npx flowstride install --with-deps
npx flowstride run --ci--with-deps also installs browser system dependencies on supported Linux runners. See native CI for workflow generation and secrets.
Connect Cloud
Cloud includes free accounts. The Flowstride Pro engine is available through an authenticated private channel, with features and usage limits determined by your workspace plan. After installing project dependencies, run:
npx flowstride login
npx flowstride statusPaste a valid developer token into the masked prompt and accept the Flowstride Pro engine installation when offered. Read the confirmed workspace and engine status. See Cloud authentication for token management.
Update your installation
Update the FS dependency in your project:
npm install --save-dev flowstride
npx flowstride install chromium firefox webkitInstall only the browsers your suite uses. For an installed Flowstride Pro engine, use:
npx flowstride updateStop a running Flowstride process before restarting with an updated installation. Run a representative flow after updating and review its assertions, reports and evidence.
If a dependency installation removes the Flowstride Pro engine, run npx flowstride login again after installing project dependencies. The launcher uses an authorized compatible Flowstride Pro engine when available and falls back to FS when the Flowstride Pro engine cannot be used. Editions and capabilities explains the distinction.
