> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whilst.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Self-Service Signup

> How the self-service workspace creation flow works

Whilst supports self-service signup where users can create a new workspace and account without admin intervention.

## Signup Flow

<Steps>
  <Step title="User visits /auth/signup">
    The signup form collects a workspace name and email address.
  </Step>

  <Step title="Organization created in WorkOS">
    A WorkOS organization is created programmatically via the API.
  </Step>

  <Step title="Database records created">
    A `tenant_account` and initial `tenant_user` (admin) are created.
  </Step>

  <Step title="Email verification">
    User is redirected to WorkOS for email verification.
  </Step>

  <Step title="Workspace ready">
    After verification, the user lands on their workspace dashboard.
  </Step>
</Steps>

## Inviting Team Members

After creating a workspace, admins can invite team members:

1. Go to **Settings → Users**
2. Click **Invite User**
3. Enter email and select role (`admin` or `member`)
4. The invite is sent via WorkOS (or email fallback)

## Roles

| Role   | Permissions                                                 |
| ------ | ----------------------------------------------------------- |
| Admin  | Full access: manage users, settings, integrations, all docs |
| Member | Create and edit docs, search, use AI assistant              |
| Viewer | Read-only access to docs and search                         |