Team Setup
Create and configure workspaces to organize your team's design system tracking.
Overview #
UiPool workspaces are collaborative spaces where teams manage patterns, components, and scan reports together. Each workspace has its own set of patterns, members, and permissions.
Creating a Workspace #
To create a new workspace:
- 1Click your workspace dropdown in the top navigation
- 2Select Create workspace
- 3Enter a workspace name (e.g., "Acme Design System")
- 4Click Create to finish setup
Workspace Structure #
Each workspace contains:
Patterns
UI workflows and experiences your team has defined
Components
Reusable UI building blocks discovered through scans
Scan Reports
Usage data from scanning your projects
Members
Team members with access to this workspace
Member Roles #
Workspaces support two roles:
| Role | Permissions |
|---|---|
| Owner | Full access: manage members, patterns, components, settings, delete workspace |
| Member | View patterns, components, and reports. Cannot modify workspace settings. |
Switching Workspaces #
If you're a member of multiple workspaces, switch between them using the workspace dropdown in the navigation bar. All data (patterns, components, reports) is scoped to the active workspace.
Workspace Settings #
Owners can configure workspace settings:
- Workspace name — Update the display name
- API key — Generate keys for CI/CD integration
- Member management — Invite and remove members
- Danger zone — Delete workspace (irreversible)
Best Practices #
- •One workspace per design system — Keep patterns and components grouped logically
- •Descriptive names — Use names like "Acme Web DS" or "Mobile Component Library"
- •Multiple owners — Assign 2-3 owners to avoid single points of failure
- •Regular cleanup — Remove inactive members and deprecated patterns
Next Steps #
Once your workspace is set up: