![Ringle](assets/ringle-logo.png)

# Registering an account

## Purpose
Create a Ringle portal account with the signup wizard: fill in your details, verify your email address with a one-time code, and get signed in automatically.

## Prerequisites
- An email address you can read; the wizard sends a 6-digit verification code to it.
- A password of at least 12 characters with an uppercase letter, a lowercase letter, a number, and a special character.
- Optionally, a phone number if you want SMS notifications later.

## Steps

### Step 1

![register-account, step-01](screenshots/register-account/step-01.png)

**Action:** Go to https://portal.getringle.com/signup, or click "Sign up here" on the login page.

**What you should see:** The signup page shows a "Create Your Account" card with a short description, a Get Started button, "Free to start" and "No credit card" badges, and a link back to the login page for existing accounts.

### Step 2

![register-account, step-02](screenshots/register-account/step-02.png)

**Action:** Click Get Started.

**What you should see:** The signup wizard opens as a dialog titled "Create Your Account" with a two-step progress bar: Create Account, then Verify Email. The first step shows fields for First Name, Last Name, Email, Phone Number (optional), and Password with a show password toggle. The helper text explains the password rules.

### Step 3

![register-account, step-03](screenshots/register-account/step-03.png)

**Action:** Type your first name, last name, email address, and password. The phone number is optional; it only matters if you want SMS notifications later. Use the eye icon to check the password as you type.

**What you should see:** All required fields show your input, with the password masked. The Next button is ready at the bottom right, next to the "1 of 2" step counter.

### Step 4

![register-account, step-04](screenshots/register-account/step-04.png)

**Action:** Click Next.

**What you should see:** The account is created and the wizard advances to "Verify Your Email" (step 2 of 2). It shows the address the code was sent to, a Verification Code field expecting 6 digits, a disabled Verify Email button that activates once the code is complete, and a Resend Code button. Codes expire after 10 minutes.

### Step 5

![register-account, step-05](screenshots/register-account/step-05.png)

**Action:** Open the verification email in your inbox. Type the 6-digit code into the Verification Code field. If the email has not arrived after a minute or two, check your spam folder or click Resend Code.

**What you should see:** The code appears in the field and the Verify Email button becomes clickable.

### Step 6

![register-account, step-06](screenshots/register-account/step-06.png)

**Action:** Click Verify Email.

**What you should see:** Your email is verified and you are signed in automatically. A brand-new account with no workspace yet lands on the "Request Workspace Access" page, where you can submit a workspace request or jump straight into the demo. The header now shows Home, Dashboard, and Log Out. Accounts that already have workspace or demo access land on the matching dashboard instead.

## Troubleshooting
- No verification email: check the spam folder. The Resend Code button has a 60 second cooldown between sends, and each code expires 10 minutes after it is issued.
- The code is rejected: make sure you entered the most recent code; requesting a new one invalidates the previous code. Expired codes fail with an error and you can resend.
- The password is rejected: it needs at least 12 characters including an uppercase letter, a lowercase letter, a number, and a special character.
- The phone number is rejected: enter it in international format with the country code, for example +12345678901.
- "Registration failed" with an email that already has an account: sign in from the login page instead, or use the password reset flow if you have lost the password.

## Notes
- Route: `/signup`.
- Source component: `components/auth/UserSignupWizard.jsx`, opened from `pages/SignupPage.jsx` in the portal app.
- The wizard has two steps: Create Account and Verify Email. New accounts are created with SMS notifications off; you can opt in later from account settings, which is also when a provided phone number gets verified.
- After verification the wizard signs you in without a separate login. Where you land depends on the account: no memberships goes to the workspace access request page, workspace members go to their dashboard, demo users go to their demo workspace.