← All posts
Guide

Workspaces, members, and roles

TestVibe organizes everything around a workspace: it is the container that holds your projects, and it decides who can see and change them. This guide covers the two kinds of workspace, how to invite teammates, what the four roles actually control, and a few patterns for keeping a growing set of projects tidy.

Personal vs. team workspaces

Every user gets a personal workspace automatically at sign-up. It is yours: your own projects live there, and it never gains additional members. It is the right home for a spike, a personal side app, or evaluating TestVibe before you bring a team in.

A team workspace is shared. Members join by invite, by an invite link, or by an approved access request. Roles are per workspace, so the same person can be an Owner in one workspace and a Member in another.

The distinction that trips people up: projects belong to the workspace that created them. If a teammate can't find a project, the first thing to check is the workspace switcher in the header — it shows the projects for one workspace at a time. Switching workspaces changes which projects you see, not your permissions.

To create a team workspace, choose + New workspace from the workspace switcher. The form creates the workspace and its first project in one step: you enter a workspace name and, right below it, the same minimal project fields used everywhere else (name, base URL, optional framework). If you'd rather start empty, use the Skip for now — create the workspace only link below the form. Either way a new workspace starts as a 0-credit shell — there's no forced checkout — and you pick a plan later from Settings → Billing when you're ready.

Inviting members

Membership is managed entirely inside TestVibe, from Settings → Members. It does not depend on GitHub teams or repository permissions, and TestVibe never auto-joins anyone by email domain.

To invite someone:

  1. Open Settings → Members in the workspace.
  2. Enter the teammate's email address and choose a role. Only an Owner can invite another Owner.
  3. Send the invite.

The invited teammate gets a purpose-built entry point. The moment they open TestVibe or the invite link, they see a "You've been invited to <workspace>" screen that names who invited them — not a generic sign-in or a "create your first project" prompt. If they're making a new account, signing up with the exact invited email skips the usual email-verification step. Once they accept, the workspace shows up in their switcher.

You can also copy an invite link from the same panel and share it directly. Anyone who opens it and signs in joins with the role the link carries — convenient, but treat the link like a shared secret, since it hands out that role to whoever holds it.

Finally, there are access requests. When someone opens a link to a project outside their own workspaces, TestVibe shows an access-request dialog instead of the project. An Owner or Admin of that workspace can approve the request to add them.

What the roles control

TestVibe has four roles. They form a straightforward ladder from read-only to full control.

RoleWhat it allows
OwnerFull control of the workspace: members, roles, ownership transfer, billing, and deleting the workspace.
AdminInvite and remove members, approve access requests, manage projects and settings.
MemberDay-to-day testing work in the workspace's projects — edit, run, and generate.
ViewerRead-only: can view projects, tests, and results, but cannot spend credits or change settings.

Two things are worth internalizing. First, only an Owner can invite another Owner and manage billing — that keeps financial control narrow. Second, Viewer is genuinely read-only: a Viewer can't kick off a run or a generation because both spend credits. That makes Viewer the safe role for a stakeholder who wants visibility into test health without any risk of touching the bill.

You can confirm the active workspace, its type, your role, and the member count at a glance from Settings → Profile.

The Profile settings panel showing the Workspace card: name, type, your role, and member count.
The Profile settings panel showing the Workspace card: name, type, your role, and member count.

If a permission change doesn't seem to take effect, refresh TestVibe or sign in again so the workspace reloads current permissions.

How teams organize projects

A project in TestVibe maps to one web app — a name plus the site URL(s) to test. There's no single right way to slice them, but a couple of patterns hold up well.

One project per app or major area. Name projects after what they cover — customer-portal, billing-checkout — so the purpose is obvious in the switcher and the project list. Avoid throwaway names unless you truly mean to replace the project.

One workspace per team or product line, not per environment. Environments (staging, production, a preview URL) belong inside a project, added in Settings → Environments — not as separate workspaces. Reserve separate workspaces for genuinely separate teams, billing boundaries, or products, since each workspace is its own membership and plan.

Match roles to how people actually work. Engineers who write and run tests are Members. A tech lead or QA lead who also manages people and settings is an Admin. Product managers and stakeholders who just want to watch results are Viewers. Keep the Owner set small.

When a project already exists, teammates join by accepting a Members invite or by requesting access from a shared project link — no repository access required either way.

Workspaces and roles are the boundary that lets a team share AI-generated Playwright tests without stepping on each other's runs or bill. Set them up once and the rest of TestVibe just follows the active workspace. See the Members & roles docs for the full reference, or get early access to try it with your team.

Early access

Ready for tests that write themselves?