Workspaces


Arcweave Workspaces

Overview

Workspaces allow teams to easily create, manage, and share projects among their members.

Users can create workspaces, invite members, and assign them roles. Based on their roles, workspace members have varying access permissions for the workspace's projects and settings.

There are 3 types of workspaces: Basic, Pro, and Team. A user's account may have any number and combination of these 3 types.

Each workspace functions independently from the others, having its own sections for projects, members, settings, billing, and API keys.

{success} Workspace plans have replaced Arcweave’s previous Basic, Pro, and Team account plans. For more details on this change, see this blog post, as well as Arcweave's pricing page.

Workspace roles

A role represents a collection of permissions assigned to any Member of the workspace.

All workspaces include 3 predefined roles: Owner, Editor, and Viewer. Team workspaces can add custom roles.

All roles may appear multiple times in a workspace. Although a workspace’s first Owner is the user creating it, more Owners can then be added.

Here is a cheatsheet of the roles’ permissions:

  • Viewer:
    • has access to workspace's Project List
    • can view and comment on all projects of the workspace.
  • Editor:
    • has Viewer permissions, plus:
    • edits all projects of the workspace
    • creates projects in the workspace (see role of Project Owner under Project roles)
    • has Export permissions for all projects of the workspace
    • can delete projects they have created.
  • Owner:
    • has Editor permissions, plus:
    • invites Members to the workspace
    • assigns/changes/revokes Member & Guest roles and permissions
    • can delete any project of the workspace.
    • can modify workspace's Settings
    • manages the workspace's Billing.

{success} Team workspaces give their Owners the freedom to create custom roles and assign them to their Members.

Project roles

Besides workspace roles, there are also roles a user can have on a project level:

  • Project Viewer:
    • can view the project and its Play Mode
    • can leave comments and replies in the project.
  • Project Editor:
    • has Project Viewer permissions, plus:
    • can edit the project
    • can access the project's debugger
    • can export the project.
  • Project Owner:
    • has Project Editor permissions, plus:
    • can invite/remove workspace Members and Guests to the project
    • can manage the project's roles
    • can transfer ownership of the project to another workspace Member
    • can change project's public view
    • can duplicate the project (Pro / Team workspaces)
    • can delete the project.

Workspace Guests

As seen further above, workspace Owners and Editors can invite users that are not Members of the workspace to collaborate in specific projects.

These invited users implicitly get the role of Guest.

Guests:

  • are invited to specific projects, given a project role—Project Editor or Project Viewer
  • can access only the specific projects
  • cannot view the workspace's Project List
  • cannot create or delete projects in the workspace
  • are either billable (for Project Editors—counting as 1 seat, billing-wise) or free (for Project Viewers).

The Guest role is not directly assignable as a workspace role. If all project roles are revoked from a Guest, they automatically lose their Guest role.

{success} Remember: a workspace's Member is a user with any workspace role except Guest.

Inviting Guests to a project

To share a project with a person outside the workspace:

  • Open the project
  • Click on Share & export—the paper airplane icon at the top right of the project
  • Select Share from the menu
  • On Invite someone by email..., type the email of the person to be invited
  • Select the role: Viewer or Editor
  • Click on Invite.

Project Visitors

A Visitor is anyone viewing a project or its Play Mode solely due to it having public status. They are neither workspace members nor Guests—in fact, they may not even have an Arcweave account at all.

{info} Visitors cannot leave or read comments in the project they are viewing.

The Visitor role is not an assignable project role; it is automatically and temporarily assigned to anyone viewing a public project, to which they otherwise have no other connection.

Creating a workspace

Every new account has a default Free workspace named after its user. This first workspace includes the Interactive Fiction Example project The Castle.

To create a new workspace:

  • go to your account's main page
  • click on the current workspace's name, at the top left of the screen
  • choose + Create new workspace
  • name it
  • click Create.

A new, empty workspace will be created.

Workspace sections

Each workspace has distinct sections for its:

  • Projects: the workspace's project list.
  • People: the list of the workspace's Members and Guests, as well as any Invitations to users to join the workspace.
  • Roles: the roles used in the workspace, with their full lists of permissions. Team workspaces can create custom roles.
  • Settings: workspace name and icon, billing email, as well as options to upgrade and delete the workspace.
  • Billing: invoicing settings, detailed billing breakdown and history.
  • API: the list of all API keys used in the workspace.

Managing Members

A workspace's Owner can manage the Members of their workspace.

Adding Members

To add a user as a Member of the workspace, you must first invite them. Then, they have to accept the invitation from their end.

To invite a user as a Member:

  • go to the workspace's People section
  • press the + Add Member button
  • type the invitee's email address and select a role to assign to them from the dropdown menu
  • press Invite.

The new invitation will be added to the Invitations tab of the People section.

{info} Adding a Member to a Pro or Team workspace affects the workspace’s billing. When the invited user accepts their invitation, the workspace gets charged the prorated amount for the current monthly billing cycle.


{success} To a Basic workspace, you can add an infinite number of Members.

To resend or cancel a pending invite:

  • go to the workspace's People section
  • click on the Invitations tab
  • find the invitation on the list
  • click the ••• icon at the end of its row
  • choose Resend invite or Cancel invitation.

{info} To change an invitee's role, you must first cancel the pending invitation and then invite them again, choosing the desired role.

Changing Member roles

To change the role of a workspace's Member:

  • go to the workspace's People section
  • click on Role column dropdown, in the Member's row
  • choose the desired role.

{info} A workspace must have at least one Owner. If you are the sole Owner of a workspace, you cannot change your role before adding another Owner.

Removing Members

To remove a Member from the workspace:

  • go to the workspace's People section
  • click on the ••• icon, at the end of the Member's row
  • choose Remove.

Deleting a workspace

To delete a workspace:

  • go to the workspace's Settings section
  • click Delete
  • type the workspace's name and press Continue.

Creating custom roles

Team workspaces allow their Owners to create custom workspace roles and assign them permissions.

{info} The default roles of Owner, Editor, and Viewer cannot be customised.

Creating a custom role

To create a new role:

  • go to the Roles section of the workspace
  • under the existing list of roles, press + New workspace role
  • type a Name and a Description for the new role and press Save
  • toggle the permissions you want the new role to have on and off.

Available permissions

To customise a role, you can toggle on and off any of the following permissions:

Permission Description
Manage workspace Can edit the Settings section of the workspace (including deleting the workspace itself)
View memberships Can view workspace Members
Manage memberships Can invite Members and edit their roles (requires "View memberships" permission to be on)
Delete memberships Can remove Members (requires "View memberships" permission to be on)
View projects Can view the workspace's project list, the workspace's projects, and their Play Modes
Comment on projects Can leave and reply to comments on the workspace's projects (requires "View projects" permission to be on)
Edit projects Can edit the workspace's projects (requires "View projects" permission to be on)
Duplicate projects Can duplicate projects (requires "View projects" permission to be on)
Manage projects Can change projects settings (requires "View projects" permission to be on)
Delete projects Can delete projects (requires "View projects" permission to be on)
Create projects Can create projects (requires "View projects" permission to be on)
Export projects Can export projects (requires "View projects" permission to be on)
Export projects backup Can export project backup (in .arcw format) (requires "View projects" permission to be on)
Import projects Can import projects from backup files (.arcw format) (requires "View projects" permission to be on)
Manage roles Can view, edit, and delete the workspace's roles
View API keys Can view the workspace's API keys
Create API keys Can create API keys for the workspace (requires "View API keys" permission to be on)
Manage API keys Can rename and delete API keys (requires "View API keys" permission to be on)
Manage billing Can manage the workspace's Billing settings

Deleting a custom role

To delete a custom role:

  • go to the Roles section of the workspace
  • choose the custom role you want to delete
  • scroll down, under all the permissions and press the Delete button
  • press Delete on the confirmation popup.

Basic & Pro/Team Workspace comparison

A Basic workspace can have up to 3 projects. There is no such limit for Pro/Team workspaces.

{info} A Pro/Team workspace that gets downgraded to Basic retains its existing number of projects but, if exceeding the limit of 3, no more projects can be added.

Every project of a Basic workspace has a 200-item limit. Projects of Pro/Team workspaces do not have an item limit.

{info} The projects of a Pro/Team workspace that gets downgraded to Free retain their existing number of items but, if exceeding 200, no more items can be added.

A workspace Owner may invite an unlimited number of Members to the workspace.

{success} In Basic workspaces, Members are added for free.


{info} In Pro/Team workspaces, adding/removing Members affects the workspace's billing.