User Registration

Registration is the first step to using the EduShade platform. Users can create accounts using their email address, phone number, or through social login providers.

Registration Methods

1. Email Registration

The most common registration method. Users provide:

Steps:

1. Navigate to the Register page (/auth/register)
2. Enter your full name
3. Enter your email address
4. Create a password that meets the password requirements (shown in real-time)
5. Click Register
6. You will be redirected to the Email Verification page to verify your email

2. Phone Registration

Users can also register using their phone number:

Steps:

1. Navigate to the Register page
2. Toggle to Phone mode (click the phone icon)
3. Enter your full name
4. Enter your phone number
5. Create a password
6. Click Register
7. You will be redirected to the Phone Verification page to verify your phone

3. Social Login Registration

You can register instantly using a social account. See OAuth & Social Login for details.

Providers visible on the register page today: Google and Facebook. Apple and GitHub are supported by the backend but their UI buttons are not currently rendered (Apple is commented out; no GitHub button exists yet) — see the OAuth doc for the full matrix.

When registering via social login, your name, email, and avatar are automatically populated from your social profile, and the email may be auto-verified if the provider confirms it.

What the Registration Form Actually Collects

The register form (/auth/register) only asks for name, email or phone, and password — nothing more. Optional profile fields (date of birth, gender, address, designation, expertise, bio, social links, etc.) are collected later via:

• The Profile Completion wizard, when required by the tenant, or
• Account Management at any time after sign-up.

The backend RegisterRequest DTO does accept additional fields, but they are not exposed by the standard register UI today.

Password Requirements

The platform enforces configurable password policies. During registration, you'll see a Password Requirements Panel showing:

• Minimum length — Typically 8 characters (configurable per tenant)
• Complexity rules (if enabled):
  • At least one uppercase letter (A-Z)
  • At least one lowercase letter (a-z)
  • At least one number (0-9)
  • At least one special character (!@#$%^&*)

The panel updates in real-time as you type, showing green checkmarks for met requirements.

What Happens After Registration

1. Account is created with status pending_verification
2. Default role: Every new user is created as a Learner (is_learner = true)
3. Verification required: Depending on the registration method:
   • Email registration → Email verification OTP is sent
   • Phone registration → SMS OTP is sent
4. Redirect: You are automatically redirected to the appropriate verification page
5. Once verified, your account status changes to active

Reactivating a Deleted Account

If you previously deleted your account and try to register with the same email/phone:

• The system checks the tenant's data retention policy
• If your data is still within the retention period, you may be able to reactivate your previous account
• A verification code is sent to your original email/phone to confirm identity
• If beyond the retention period, a new account is created

Rate Limiting

To prevent abuse, registration is rate-limited to 5 requests per 5 minutes per IP address. If you exceed this limit, you'll need to wait before trying again.

Troubleshooting