Collaborators

Chromatic keeps track of UI feedback and tests in one place so that collaborators stays aligned without you having to do extra work.

Organization collaborators

Chromatic mirrors access permissions with your GitHub Organization, Bitbucket Group, or GitLab Team. Users who have access to your organization will also have access to your Chromatic organization.

Organization collaborators can manage billing and account status but may not have access to projects. You need to be a project collaborator to view and manage projects.

Go to your organization’s Settings page to view collaborators.

Project collaborators

Chromatic syncs access permissions with your GitHub, Bitbucket, or GitLab repository. Users who have access to your code will also have access to your project.

Project collaborators can view and manage the project based on their role. Go to your project’s Manage page to view collaborators and assign roles.

You can add or remove a collaborator by adjusting their access in your Git repository. The permission changes in your upstream repository are mirrored downstream in Chromatic.

Manually override the mirrored permissions by adjusting collaborator roles or inviting external collaborators on an ad hoc basis.

If you signed up via email and password, Chromatic won’t have a Git repo to sync with. You’ll need to manage project collaborators manually via external collaborators below.

External collaborators

Projects can also have external collaborators. These are stakeholders like PMs, designers, and consultants who don’t commit code but contribute to the sign off process. They can also be fellow developers who don’t have repo access or use a different Git provider.

External collaborators are added and removed manually. Once they create an account, they’ll get access to your project. There are two ways to add collaborators:

• Invite link: Share a URL with stakeholders. They are auto-assigned a developer role.
• Invite email: Send individual invites via email. You can fine tune roles before sending.

Roles

Roles give you fine-grained control over who can do what. There are four roles that can be assigned to any collaborator.

Each project has a unique set of roles that are managed by the project owner. For example, you can be an “developer” in one project and a “viewer” in another.

Project ownership

Projects must have at least one owner. The owner role is automatically assigned to the first user in a Chromatic project.

Transfer ownership by assigning another collaborator as an owner and then reassigning yourself another role.

View your role

Go to your project’s Manage page to view your role and it’s capabilities.

Roles for open source projects

Open source projects are viewable to all users even if they’re not listed as a collaborator or have a Chromatic account. But in order to manage or review the open source project, collaborators must have explicit access and the corresponding role.

Visibility

By default, published Storybooks on Chromatic are private. They can only be accessed by collaborators who are signed in to Chromatic and have permission to view components and builds.

When you set Storybook visibility to public, it will be accessible to visitors without signing in. Anyone with a link can access. Your Chromatic library, tests, and settings will remain private.

Troubleshooting