Workspace Management
Learn how to create workspaces, manage team members, assign roles, and configure workspace settings in FlagShark.
Workspaces in FlagShark represent your GitHub organization or account. They're the container for all your repositories, flags, team members, and settings. This guide covers everything you need to know about managing workspaces effectively.
Creating a Workspace
Workspaces are created automatically when you install the FlagShark GitHub App:
Screenshot needed: unknown → unknown
Switching Workspaces
If you belong to multiple workspaces, use the workspace switcher in the sidebar:
- Click your current workspace name in the sidebar
- A dropdown shows all your workspaces with:
- Workspace name and avatar
- Your role (Owner, Admin, or Member)
- Repository count
- Click a workspace to switch to it
Your selection is persisted across sessions—FlagShark remembers your last active workspace.
Team Roles
FlagShark uses three roles with distinct permissions:
| Role | Description |
|---|---|
| Owner | The user who installed the GitHub App. Has full access and cannot be removed. |
| Admin | Full access to workspace settings, team management, and all features. |
| Member | Read-only access. Can view flags, activity, and dashboards but cannot modify settings. |
Permission Matrix
| Action | Owner | Admin | Member |
|---|---|---|---|
| View dashboard & flags | Yes | Yes | Yes |
| View repositories | Yes | Yes | Yes |
| View activity feed | Yes | Yes | Yes |
| Edit workspace settings | Yes | Yes | No |
| Manage team members | Yes | Yes | No |
| Send invitations | Yes | Yes | No |
| Remove members | Yes | Yes | No |
| Delete workspace | Yes | Yes | No |
| Change own role | No | No | No |
| Be removed | No | Yes | Yes |
Inviting Team Members
Admins and owners can invite new team members:
Invitation Details
- Invitations are sent via email with a 7-day expiration
- The invitee clicks the link to create their FlagShark account (or sign in)
- Once accepted, they appear in your team list with their assigned role
Team Size Limits
Your subscription tier determines the maximum team size:
| Tier | Included Seats | Additional Seats |
|---|---|---|
| Free | 1 | Not available |
| Pro | 5 | $10/seat/month |
| Team | 20 | $8/seat/month |
| Enterprise | Unlimited | Contact sales |
Managing Team Members
In the Settings → Team tab, you can:
Change Roles
- Find the team member in the list
- Click the role dropdown next to their name
- Select the new role (Admin or Member)
- Changes take effect immediately
Remove Members
- Find the team member in the list
- Click the Remove button (or trash icon)
- Confirm the removal
Removed members lose access immediately but can be re-invited later.
Workspace Settings
Configure your workspace in Settings. Available tabs depend on your role and subscription:
General Tab
- Display Name — Custom name for your workspace
- Workspace ID — Unique identifier (read-only)
- Delete Workspace — Permanently remove the workspace and all data
Repositories Tab
Select which repositories FlagShark should track:
- Toggle tracking on/off per repository
- See flag count per repository
- Bulk enable/disable all repositories
Automation Tab
Configure automatic flag cleanup:
| Setting | Description | Default |
|---|---|---|
| Auto-Removal Enabled | Automatically create removal PRs for stale flags | Off |
| Stale Threshold | Days until a flag is considered stale | 90 days |
| Create as Draft | Create removal PRs as draft PRs | On |
| Permanent Flags | List of flag names to never mark as stale | Empty |
| Excluded Repos | Repositories to exclude from auto-cleanup | Empty |
Notifications Tab
Configure how your team gets notified. See Notifications & Alerts for details.
Integrations Tab
Connect third-party services:
- LaunchDarkly — Sync flag status from LaunchDarkly
- Slack — Send notifications to Slack channels
Billing Tab
Manage your subscription:
- View current plan and usage
- Upgrade or downgrade plans
- Update payment method
- View invoice history
Security Tab
Security and compliance settings:
- View audit log
- Configure SSO (Enterprise only)
- Manage API keys
Data Tab
Export and manage your data:
- Export workspace data (JSON/CSV)
- Request data deletion
- View data retention settings
Best Practices
Workspace Organization
Role Assignment Guidelines
| Scenario | Recommended Role |
|---|---|
| Engineering managers | Admin |
| Senior engineers | Admin |
| Individual contributors | Member |
| Contractors | Member |
| Interns | Member |
Security Recommendations
- Limit admin access — Only give admin roles to people who need to manage settings
- Review team regularly — Remove members who have left the organization
- Use SSO — Enterprise plans should enable SSO for centralized access control
Troubleshooting
"You don't have access to this workspace"
- Your invitation may have expired (7-day limit)
- You may have been removed from the workspace
- Ask a workspace admin to re-invite you
"Team member limit reached"
- Your subscription has a maximum team size
- Upgrade your plan or remove inactive members
- Contact support for enterprise options
"Cannot find organization during installation"
- Ensure you have admin access to the GitHub organization
- The organization may have restricted third-party app installations
- Contact your GitHub organization owner