Signup Flow
1
User visits /auth/signup
The signup form collects a workspace name and email address.
2
Organization created in WorkOS
A WorkOS organization is created programmatically via the API.
3
Database records created
A
tenant_account and initial tenant_user (admin) are created.4
Email verification
User is redirected to WorkOS for email verification.
5
Workspace ready
After verification, the user lands on their workspace dashboard.
Inviting Team Members
After creating a workspace, admins can invite team members:- Go to Settings → Users
- Click Invite User
- Enter email and select role (
adminormember) - The invite is sent via WorkOS (or email fallback)

