Create Your First Workflow
In this tutorial you'll build a simple two-node workflow in the Playrunner visual editor: an Environment config node feeds variables into a Playwright test run.
Prerequisites: Complete Getting Started first.
Step 1 — Open the Editor
Navigate to the URL printed by ./start-local.sh and click Editor in the sidebar. With defaults, that is http://127.0.0.1:3100. The canvas opens with an empty workflow.
Step 2 — Add an Environment node
- Click the + button to open the node selector.
- Choose Environment.
- The node appears on the canvas. Click it to open its configuration panel.
- Add a variable your tests can use, such as
BASE_URL.
Step 3 — Add a Playwright node
- Open the node selector again.
- Choose Playwright.
- Drag it to the right of the Environment node.
Step 4 — Connect the nodes
Click the output port on the right edge of the Environment node and drag a connection line to the input port on the left edge of the Playwright node.
The workflow now reads: "Use these environment variables → run Playwright tests".
Environment and Schedule nodes do not accept inbound workflow connections. If you open the node selector while drawing a connection, nodes without inbound support appear disabled as connection targets.
Step 5 — Configure the Playwright node
Click the Playwright node to open its panel:
- Repository — select a GitHub repo (you'll connect GitHub in the next tutorial)
- Branch — choose a branch, e.g.
main - Playwright version — pick the version matching your project
Step 6 — Save the workflow
Click Save in the top toolbar. Your workflow is persisted to PostgreSQL through the Prisma-backed API and will be available next time you open the editor.