Teams and Roles

Teams on Stormkit allow you to collaborate with members on applications with role-based access control.

Overview

Create teams to collaborate with your colleagues on Stormkit. Teams enable you to organize projects, manage access, and collaborate effectively with role-based permissions.

Create a Team

A Personal team is created by default for each member. This space is to allow users manage their personal projects.

If you’d like to collaborate with other team members, you’ll have to create a new team.

1. Open team selector

   Click on the Team Toggle on the upper left part of the screen

2. Create team

   Click on Create Team

3. Name your team

   Give your team a name (e.g., “ACME Inc”, “Marketing Team”, “Engineering”)

4. Confirm creation

   Click Create to finalize the team creation

Roles and Permissions

There are three roles available in Stormkit:

Owner

Full control over the team, including billing and team deletion.

Admin

Manage apps, deployments, and team members. Cannot manage billing or delete the team.

Developer

Manage apps, deployments, and environments. Cannot manage team members or delete apps.

Permissions Matrix

The table below illustrates the permissions each role has:

Feature	Owner	Admin	Developer
Manage app settings	✅	✅	✅
Manage deployments	✅	✅	✅
Manage environments	✅	✅	✅
Delete an app	✅	✅	❌
Migrate an app	✅	✅	❌
Invite members to the team	✅	✅	❌
Remove members from the team	✅	✅	❌
Delete team	✅	❌	❌
Billing	✅	❌	❌

Managing Team Members

Inviting Members

1. Access team settings

   Navigate to your team’s settings page

2. Invite member

   Click on Invite Member button

3. Enter details

   • Enter the member’s email address
   • Select their role (Owner, Admin, or Developer)
4. Send invitation

   Click Send Invitation. The member will receive an email invitation.

You need at least Admin role to invite members to the team.

Removing Members

1. Access team members

   Navigate to your team’s members list

2. Select member

   Find the member you want to remove

3. Remove

   Click the remove button and confirm the action

Removing a member will immediately revoke their access to all team applications.

Changing Member Roles

Owners and Admins can update member roles:

1. Navigate to team members list
2. Click on the member’s current role
3. Select the new role from the dropdown
4. Changes take effect immediately

Migrating an App

To migrate an application from a team to a different one:

1. Navigate to app settings

   Go to the Settings page of your application

2. Find migration section

   Scroll down to find the Migrate app section

3. Select destination team

   Select the team you’d like to migrate the app to from the dropdown

4. Confirm migration

   Click Migrate and confirm the action

Requirements:

• You must have at least Admin role for both teams (source and destination)
• All deployments, environments, and configurations will be migrated
• Team-specific integrations may need to be reconfigured

Use Cases

Agency Teams

Create separate teams for each client, managing multiple projects with appropriate access levels.

Department Teams

Organize teams by department (Engineering, Marketing, Design) with role-based access.

Project Teams

Create teams around specific projects or products for focused collaboration.

Freelance Collaboration

Invite clients as Developers to review deployments without full access to settings.

Best Practices

Role Assignment

• Use Developer role for most team members - Gives them what they need without administrative overhead
• Limit Owner role - Only assign to those who need billing access
• Admin for team leads - Give Admin role to project leads and senior team members
• Review roles regularly - Audit and update roles as team members’ responsibilities change

Team Organization

• Keep teams focused - Create separate teams for different clients or major projects
• Use descriptive names - Make it clear what each team is for
• Personal team for experiments - Keep personal projects in your Personal team
• Document team purpose - Maintain documentation about what each team manages

Security

• Remove inactive members - Regularly review and remove members who no longer need access
• Principle of least privilege - Give members the minimum role needed for their work
• Regular audits - Periodically review team membership and roles
• Protect Owner role - Ensure at least 2-3 owners per team for business continuity

Billing

Only team Owners can manage billing settings, view invoices, and update payment methods.

Billing is handled at the team level:

• Each team has its own billing account
• Usage is tracked per team
• Personal team billing is separate from organization teams
• Migrating apps between teams may affect billing

Troubleshooting

Cannot invite members

• Verify you have Admin or Owner role
• Check that the email address is valid
• Ensure the team subscription supports additional members
• Check if the user already has an invitation pending

Cannot migrate app

• Verify you have Admin role in both teams
• Check that the destination team exists
• Ensure you’re not migrating to the same team
• Contact support if the issue persists

Missing permissions

• Check your current role in the team
• Contact a team Owner or Admin to update your role
• Verify you’re in the correct team
• Some features may require specific roles

Cannot delete team

• Only Owners can delete teams
• Remove all applications from the team first
• Ensure all members except owners are removed
• Cancel any active subscriptions