Onboarding
The first-run flow that puts you in a team before you reach the workspace.
Onboarding
Piyaz is team-scoped, so every project lives inside a team. The first time you sign in without belonging to any team, onboarding sends you to a single page that asks you to land in one. Once you are a member of any team, this page redirects you home, because the workspace already spans every team you belong to.
The form
The card has two tabs.
Create team
Enter a team name and a URL slug. The slug accepts lowercase letters, digits, and hyphens, 2 to 32 characters, and the name field is prefilled with a placeholder built from your display name. Submitting creates the team and makes you its owner.
Join with code
Paste the 21-character invite code a team admin shared. Submitting accepts the invitation and adds you to that team. Invite codes are generated in Settings under the Teams section.
If either action fails, the form shows the error inline and keeps your input.
Where onboarding fits
Onboarding is the gate between signing in and doing work. You cannot create or see projects until you belong to a team, because a team owns the projects and scopes who can read and write them. After you create or join one, you arrive at the home page, where the Projects grid lists what that team is working on. To create more teams or invite others later, use Settings.