Workspaces

What are workspaces?

Workspaces are team collaboration spaces where you can share projects, credits, and integrations with other members. Each workspace has its own billing, settings, and permission management.

Every user has a workspace:

• Created automatically when you sign up

• Your personal workspace (you're the owner)

• Can invite team members (Pro tier required)

Why workspaces matter:

• Team collaboration: Work together on projects

• Shared credits: Pool resources across the team

• Shared integrations: Configure once, use across all projects

• Centralized billing: One subscription for the team

• Access control: Manage who can do what

Key concept: Projects belong to workspaces, not individuals. When team members leave, projects stay in the workspace.

Workspace features

Shared credits

All workspace members draw from the same credit pool.

Credit sharing:

• Credits belong to the workspace, not individuals

• Any member can use available credits

• Usage tracked per member

• Visible to all team members

Benefits:

• Team doesn't need individual subscriptions

• Flexible allocation based on workload

• Simple billing (one plan for everyone)

Shared projects

Projects created in a workspace are accessible to all members.

Project access:

• All members can view workspace projects

• Permissions depend on role (see below)

• Private projects stay within workspace

• Public projects visible to everyone

Shared integrations

Configure integrations once at the workspace level.

Available to all workspace projects:

• GitHub organizations

• Vercel teams

• Supabase organizations

• Stripe integrations

• Context7 API keys

Benefits:

• Setup once, use everywhere

• Consistent configuration

• Easier management

Team collaboration

Work together on the same projects.

Collaboration features:

• Multiple people can work on same project

• Real-time updates

• Shared chat sessions

• Comment and discuss

• Track who did what

Billing management

Workspace owners manage billing for the entire team.

Centralized billing:

• One subscription covers all members

• Owner manages payment methods

• View team-wide credit usage

• Purchase credits for the team

Roles and permissions

Workspaces have three roles with different permission levels.

Role comparison

*Owners cannot leave their own workspace

Owner

Full control over the workspace.

What owners can do:

• Everything Admins and Members can do

• Manage billing and subscriptions

• Delete the workspace

• Cannot be removed or demoted (unless there's another owner)

Who becomes owner:

• The user who creates the workspace

• Can only be transferred manually (contact support)

Admin

Manage team and workspace settings, but not billing.

What admins can do:

• Invite and remove members

• Promote members to admin

• Manage workspace integrations

• Change workspace settings

• Create, edit, and delete projects

• Cannot manage billing

• Cannot remove/demote other admins or owner

When to make someone admin:

• Team lead managing other members

• Senior developer needing full technical access

• Someone you trust with workspace configuration

Member

Build projects and use workspace resources.

What members can do:

• Create and edit projects

• Use workspace credits

• Access shared integrations

• Participate in chat sessions

• Fork projects

• Leave workspace anytime

What members cannot do:

• Invite other members

• Delete projects

• Manage workspace settings

• Access billing information

• Remove other members

When to make someone member:

• Regular team developers

• Contractors or temporary collaborators

• Junior developers

• Anyone who just needs to build

Collaborator limits

The number of people you can invite depends on your workspace's subscription tier.

Counting members:

• Owner counts toward limit

• Pending invitations count toward limit

• Removed members free up slots

Example (Pro tier):

• Owner (you) = 1

• Can invite 4 more people

• If you send 4 invites (pending), limit reached

• If 1 invitation expires or is cancelled, can send 1 more

Tip: Revoke expired invitations to free up slots for new team members.

Inviting team members

Add collaborators to your workspace with email invitations.

How to invite

1. Go to Workspace Settings → Members

2. Click "Invite Member"

3. Enter email address

4. Choose role (Member or Admin)

5. Click "Review invite"

6. Confirm invitation details

7. Click "Send Invite"

Invitation email sent to the recipient immediately.

Invitation email

The recipient receives an email with:

• Who invited them (your name/email)

• Workspace name

• Role they're being invited as

• Invitation link

• Expiration date (7 days from invite)

For existing App2 users:

• Email includes direct link to accept

• One click to join workspace

• Automatically switched to the workspace

For new users:

• Email includes signup link

• Create account first

• Then accept invitation

• Join workspace automatically

Invitation expiration

Invitations expire after 7 days.

Before expiration:

• Recipient can click link to accept

• Invitation shown in "Pending Invitations"

• Counts toward collaborator limit

After expiration:

• Link no longer works

• Automatically removed from pending list

• Frees up collaborator slot

• Can send new invitation

Resending invitations:

• Click "Resend invite" in pending invitations

• Extends expiration by 7 more days

• Same invitation link

• New email sent

Tip: Follow up with team members if they haven't accepted after a few days.

Managing members

Viewing members

See all workspace members in Workspace Settings → Members.

Member card shows:

• Name and email

• Role badge (Owner/Admin/Member)

• "You" badge for your own account

• Join date

• Actions menu (if you have permissions)

Members sorted by:

1. Owners first

2. Admins second

3. Members last

4. Alphabetically within each role

Changing roles

Owners and Admins can change member roles.

Promoting members:

1. Click menu (⋮) on member card

2. Select "Promote to admin"

3. Confirm promotion

4. Member gains admin permissions

Demoting admins:

1. Only owners can demote admins

2. Click menu (⋮) on admin card

3. Select "Demote to member"

4. Confirm demotion

5. Admin becomes regular member

Role change rules:

• Admins can only promote/demote Members

• Owners can promote/demote anyone except other Owners

• Cannot change your own role

• Cannot demote the last owner

Removing members

Remove team members when they're no longer needed.

Who can remove:

• Owners: Can remove Admins and Members

• Admins: Can only remove Members

• Members: Cannot remove anyone

How to remove:

1. Click menu (⋮) on member card

2. Select "Remove from workspace"

3. Confirm removal

4. Member loses access immediately

What happens when removed:

• Loses access to all workspace projects

• No longer uses workspace credits

• Cannot view workspace integrations

• Switched back to their primary (personal) workspace

• Receives email notification

Leaving workspace

Members and Admins can leave workspaces voluntarily.

How to leave:

1. Find your own member card

2. Click menu (⋮)

3. Select "Leave workspace"

4. Confirm action

5. Immediately removed from workspace

Restrictions:

• Owners cannot leave their own workspace

• You're switched to your primary workspace

• No access to workspace projects after leaving

Warning: Leaving a workspace is permanent. You'll need a new invitation to rejoin.

Primary vs secondary workspaces

Pro subscribers can create multiple workspaces with different credit allocations.

Primary workspace

Your first workspace with special benefits.

Primary workspace features:

• Created when you sign up

• Receives 10 free credits per month (Free tier)

• Always available

• Cannot be deleted

• You're always the owner

Free credit allocation:

• Free tier: 10 monthly credits (5 per day usage limit) in primary workspace

• Pro tier: Still gets 10 free credits + 100 subscription credits

Secondary workspaces

Additional workspaces for Pro subscribers.

Creating secondary workspaces:

1. Click workspace dropdown

2. Select "Create Workspace"

3. Choose Pro tier (required)

4. Enter workspace name

5. Complete checkout

6. New workspace created

Secondary workspace features:

• Requires active Pro subscription

• No free credit allocation (0 free credits/month)

• Uses only subscription credits

• Independent billing

• Separate team members

• Own integrations

Important: Secondary workspaces require Pro subscription. If you cancel Pro on a secondary workspace, it may be frozen until you renew.

Credit allocation by workspace type

Note: Each workspace has completely separate credit pools. Credits cannot be transferred between workspaces.

Best practices

Organizing teams

Small teams (2-5 people):

• One workspace for everyone

• Owner + 1-4 members

• Pro subscription

Larger teams (6-50 people):

• Upgrade to Ultra tier (coming soon)

• Or create multiple Pro workspaces by project/department

Client work:

• Separate workspace per client (Pro tier)

• Easier to track costs

• Clean access control when project ends

Managing permissions

Start with Member role:

• Give new team members Member role initially

• Promote to Admin after they're established

• Fewer Admins = easier management

Admin for leads:

• Team leads managing other developers

• Senior developers who need full access

• People you trust with workspace settings

Keep one Owner:

• Too many Owners complicates billing decisions

• Transfer ownership only when necessary

Invitation workflow

Before inviting:

• Check collaborator limit isn't reached

• Verify team member's email address

• Choose appropriate role

After inviting:

• Follow up if not accepted within 2-3 days

• Resend invitation if needed

• Cancel and re-invite if email was wrong

Managing invitations:

• Review pending invitations weekly

• Cancel expired or unneeded invitations

• Keep slots available for active team members

Common workflows

Onboarding a new developer

1. Invite as Member role

2. They receive email and accept

3. Give them project access

4. They can start building immediately

5. Promote to Admin after 1-2 weeks if needed

Setting up client workspace

1. Create new workspace (Pro tier)

2. Name it after client

3. Invite client stakeholders as Members

4. Invite your team as Admins

5. Build client projects

6. Remove client access when done

Offboarding team members

1. Ensure work is committed to GitHub

2. Remove member from workspace

3. They lose access immediately

4. Projects remain in workspace

5. Reassign their projects if needed

Troubleshooting

Can't invite members (Free tier)

Issue: "Invite Member" button disabled on Free tier.

Solution: Upgrade to Pro ($25/month) to unlock team collaboration. Free workspaces support owner only.

Collaborator limit reached

Issue: "Collaborator limit reached" message when inviting.

Solutions:

• Remove inactive members

• Cancel expired invitations

• Upgrade to higher tier (Ultra for 50 collaborators)

• Wait for pending invitations to expire

Invitation not received

Issue: Team member didn't get invitation email.

Solutions:

1. Check spam/junk folder

2. Verify email address is correct

3. Resend invitation from pending invitations list

4. Try different email address

5. Contact hello@app2.dev if persists

Can't remove member

Issue: Remove option not available or action fails.

Solutions:

• Verify you're Owner or Admin

• Admins cannot remove other Admins or Owner

• Check member hasn't already left

• Refresh page and try again

Can't change workspace settings

Issue: Settings menu disabled or changes won't save.

Solution: Only Owners and Admins can change workspace settings. Contact your workspace owner if you need settings changed.

FAQ

Can Free tier users create teams?

No. Free tier workspaces support only the owner (1 person). Upgrade to Pro to invite team members (up to 5 collaborators).

How many workspaces can I create?

Pro subscribers can create unlimited secondary workspaces. Each requires its own Pro subscription ($25/month per workspace). Free tier users get one personal workspace.

Do all members need Pro subscriptions?

No. Only the workspace needs a Pro subscription. Once subscribed, you can invite up to 5 members (Pro/Lifetime) or 50 members (Ultra) who all share the subscription benefits.

Can I transfer workspace ownership?

Not directly through the UI. Contact support at hello@app2.dev to arrange ownership transfer. Requires confirmation from both current and new owner.

What happens to projects when someone leaves?

Projects remain in the workspace. Workspaces own projects, not individuals. The team can continue working on all projects regardless of who created them.

Can members see billing information?

No. Only workspace owners can view and manage billing. Members and Admins cannot see credit card details, invoices, or subscription information.

How do I switch between workspaces?

Click the workspace dropdown in the top navigation and select the workspace you want to work in. This becomes your active workspace.

Can I move projects between workspaces?

Not directly. You can fork a project to another workspace, creating an independent copy. Original and fork are separate projects.

What's the difference between primary and secondary workspaces?

Primary workspace (your first workspace) receives 10 free credits per month. Secondary workspaces (Pro only) get 0 free credits but have their own subscription credits and billing.

Can workspace members use their own credits?

No. In a workspace, everyone shares the workspace credit pool. Individual personal credits (from other workspaces) are not accessible when working in a different workspace.

What happens if Pro subscription is cancelled?

Primary workspace: Downgraded to Free tier. Team members removed automatically. Only owner remains. Can re-invite members by re-subscribing.

Secondary workspace: Frozen until Pro subscription is renewed. No project access during freeze.

Related links

• Plans and Credits - Subscription details

• Getting Started

• Private Projects - Team access control

• FAQ