> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helloleo.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Workspace Collaboration
> Invite your team, clients, and contractors to collaborate on projects
Workspaces let you collaborate with team members, clients, and external contractors on HelloLeo projects. Projects created in a workspace run on the **workspace owner's credits** — so members can build without needing their own subscription.
## Quickstart
Click **Workspaces** in the sidebar to see all your workspaces.
Click **Switch to this workspace** so that new projects are created there — and billed against that workspace's credits.
Go to the **Members** tab and click **Invite Member**. Enter an email and select a role.
Your team members can now create and access projects in the workspace. All usage is counted against the **owner's** subscription quota.
## Use Cases
### Business Owners Inviting Contractors
You're a business owner and want your integrator or freelance developer to build apps for you:
1. Create a workspace for your company
2. Invite your contractor as **Admin** (so they can create and configure projects)
3. Ask them to **switch to your workspace** before creating any project — their work will run on your credits, not theirs
*Example: "I'm collaborating with a third-party who will be using HelloLeo to add apps to our ERP."*
### Agencies Inviting Clients
You're an agency or freelancer building apps for clients:
1. Create a workspace per client
2. Invite your client as **Viewer** (so they can see progress and validate)
3. All projects you create in that workspace run on your subscription
*This helps you showcase your work and get faster approvals.*
### Teams Collaborating Internally
Your company has multiple people working on HelloLeo projects:
1. Create a shared workspace for your team
2. Invite team members as **Member** (so they can create and edit projects)
3. Everyone works under the same subscription — only the owner needs a paid plan
## What Are Workspaces?
Workspaces are:
* **Project collections** — Group related projects together
* **Team spaces** — Share projects with colleagues, clients, or contractors
* **Access control** — Manage who can do what with roles
* **Shared billing** — Members use the owner's credits; only the owner needs a paid plan
## Workspace Types
### Personal Workspace
* **Your default** — Created automatically when you sign up
* **Your projects** — All your personal projects live here by default
* **Can have members** — You can invite collaborators to your personal workspace too
### Team Workspaces
* **Shared** — Multiple team members, clients, or contractors
* **Collaborative** — Work together on projects
* **Owner-billed** — All project usage draws from the owner's subscription quota
## Roles and Permissions
### Admin
* **Full project control** — Create, configure, and delete projects
* **Invite members** — Add people to the workspace
* **Manage integrations** — Configure workspace-level tools
* **Best for**: Contractors, developers, team leads
### Member
* **Work on projects** — Create and edit projects
* **View all projects** — See everything in the workspace
* **Limited settings** — Can't manage workspace or invite others
* **Best for**: Team members, collaborators
### Viewer
* **View only** — See projects but can't edit
* **Read access** — Perfect for clients reviewing work
* **No changes** — Can't modify anything
* **Best for**: Clients, stakeholders, reviewers
## Inviting Team Members
1. Go to **Workspaces** in the sidebar
2. Click on the workspace you want to manage
3. Go to the **Members** tab
4. Click **Invite Member**
5. Enter the email address
6. Select a role (Admin, Member, or Viewer)
7. Click **Send Invitation**
The invited person will receive an email with a link to join the workspace.
## Managing Projects
In the **Projects** tab of your workspace, you can:
* **View all projects** — See every project in the workspace
* **Click to open** — Jump directly into any project's chat
* **See project status** — Check which projects are deployed
A project's billing is determined at creation time by the workspace it belongs to. If you accidentally create a project in your personal workspace instead of a team workspace, it will use your personal credits — not the team owner's.
### Copying a Project to Another Workspace
When you duplicate a project, you can choose which workspace the copy should be created in:
1. Go to your **Projects** page
2. Click the **Copy** button on the project you want to duplicate
3. If you have multiple workspaces, a **Destination workspace** selector appears in the modal
4. Select the target workspace (defaults to the project's current workspace)
5. Click **Copy Project**
The new project is created in the selected workspace with all the source code from the original. Environment variables and integrations are not copied.
The workspace selector only appears if you are a member of two or more workspaces. If you only have your personal workspace, the copy is created there automatically.
## Workspace Settings
In the **General** tab, workspace owners and admins can:
* **Rename workspace** — Update the workspace name
* **Update avatar** — Add a logo or image
* **Add description** — Describe what the workspace is for
* **Delete workspace** — Remove the workspace (careful!)
## Best Practices
* **Switch before you create** — Always switch to the right workspace before creating a project; that's what determines whose credits are used
* **One workspace per client** — If you're an agency, create a workspace for each client so billing stays separate
* **Use Viewer for clients** — Let clients see progress without risking accidental changes
* **Use Admin for contractors** — Give contractors full access to build and configure
* **Regular cleanup** — Remove members who no longer need access
Learn about managing projects
Configure individual project settings