Workspaces, members & roles

A workspace is the top-level container for projects, design systems, and people. Every member holds one of three roles, and membership is by invitation — email-based, with pending invites for addresses that don't yet have a Statecraft account.

Roles

Three roles, in decreasing capability:

• Owner — full control. Can rename the workspace, invite and remove members, change member roles, manage billing, and edit every project and design system. Every workspace must have at least one owner; the last owner cannot demote themselves without promoting another member first.
• Editor — full edit access. Can create and modify projects, author design systems, take snapshots, leave and resolve comments. Cannot invite or remove members, cannot manage billing.
• Viewer — read-only. Can open projects, read JSX, open snapshots, and read comments. Cannot edit anything, cannot leave comments, does not receive comment notifications.

Role changes take effect immediately; a promoted member gains edit capability without re-logging-in, a demoted editor loses it the next time the client syncs.

Inviting members

Owners invite members from the Members page under workspace settings. Invites are sent by email and include a direct link to join the workspace. Two cases:

• The invitee has an account — the invite appears in their account immediately as a pending invite on their home screen. A workspace invite notification lands in their in-app bell.
• The invitee does not have an account — the email is the only delivery channel; the invite link prompts them to sign up, and the new account picks up the pending invite on first sign-in.

Pending invites are listed on the Members page with a revoke button. Revoking an unaccepted invite invalidates the link.

Accepting and declining

Invitees accept invites from their home screen or by clicking the email link. Accepting adds the account to the workspace with the role the inviter chose.

Declining an invite removes it from the invitee's list without notifying the inviter. A declined invite can be re-sent.

Removing members and leaving workspaces

Owners can remove any member except the last owner. Every member (including owners, provided at least one other owner exists) can leave a workspace themselves from the Members page.

Leaving revokes access to every project in the workspace. A re-invite restores access but does not restore any role history — the new role is whatever the re-inviting owner chooses.

Read-only mode

Independent of role, a workspace can enter read-only mode for billing reasons — a trial that has ended without a subscription, a subscription whose payment has failed beyond the retry window. When a workspace is read-only:

• Owners and editors can still read everything, open snapshots, and manage billing.
• Mutations (editing projects, creating snapshots, adding design systems, inviting members) are refused by the server with a neutral error.
• The editor surfaces a banner on every workspace page explaining the state and linking to Billing, trial & Pro.

Paying to reactivate an owner restores edit capability for every member of the workspace — the workspace unlocks on a single Pro-tier owner, regardless of how many other owners or editors exist.

Multiple workspaces

A single account can belong to many workspaces with different roles in each. The workspace switcher in the account menu lists every workspace the account has access to. Every project, design system, and snapshot is scoped to one workspace; nothing crosses workspace boundaries.