Sign In with Google

Overview

BlueClerk supports Google Sign-In, letting you log in instantly with your Google account on both web and mobile apps. When signing in with Google for the first time, you'll choose your account type (homeowner, contractor, or business) before your account is created. You can also link your Google account to an existing BlueClerk account from your profile settings, allowing you to sign in with either your email/password or Google.

How to Sign In with Google

First-Time Google Sign-In

When you sign in with Google for the first time:

1. Click "Sign in with Google" on the login screen
2. Select your Google account from the list
3. Authorize BlueClerk if prompted
4. Choose your account type on the type picker page:
   • Homeowner - Individual property owner
   • Individual Contractor - Self-employed tradesperson
   • Contractor Company - Contracting business with employees
   • Builder Company - Home builder managing subdivisions
   • Business Company - Commercial business or property manager
5. Your account is created and you're signed in automatically

Subsequent Google Sign-Ins

After your first sign-in:

1. Click "Sign in with Google" on the login screen
2. Select your Google account
3. You're signed in immediately - no type picker needed

Linking Google to Existing Account

If you already have a BlueClerk account with email/password, you can link your Google account:

1. Sign in with your email and password
2. Go to Settings > Profile
3. Click "Link Google Account" in the account security section
4. Select your Google account when prompted
5. Authorize the connection
6. You can now sign in with either email/password or Google

Post-Login Routing

After successful sign-in, BlueClerk routes you to your role-specific dashboard:

Homeowners

• /homeowner/dashboard

Individual Contractors

• /contractor/dashboard

Contractor Company Members

• Members without a company: /my-jobs
• Members with company: Determined by company type (see below)

Company-Based Routing

If you have a company account, routing is based on company type:

• CONTRACTOR company: /contractor-company/dashboard
• BUILDER company: /builder/dashboard
• BUSINESS company: /business/{companyId}/dashboard
• PROPERTY_MANAGER company: /property-manager/dashboard

Vendor Invite Flow

If you're signing up via a vendor invite link:

1. Complete Google OAuth as usual
2. Instead of dashboard, you're redirected to the vendor invite page
3. The next parameter from the original invite link is preserved
4. Complete the invite acceptance to join the contractor's roster

Auth Error Handling

If Google sign-in fails:

1. You'll see an error toast - "Sign in failed. Please try again or use email/password."
2. The URL is cleaned - Error parameter is removed from the URL
3. You remain on the login page - The next parameter (if present) is preserved for retry

Mobile App Behavior

The mobile app uses the same Google sign-in flow:

1. OAuth completes in the device's web browser
2. The app deep-links back to your dashboard
3. Session is established automatically

Security

• OAuth tokens are encrypted at rest in the database
• Google accounts can be unlinked from your profile settings
• Email verification not required - Google accounts are considered verified by default
• Account linking is permanent - Once linked, you can use either sign-in method

Troubleshooting

Q: I signed in with Google but see "Account not found"? A: You need to complete the account type picker on first sign-in. If you closed that page, sign out and try signing in with Google again.

Q: Can I link multiple Google accounts to one BlueClerk account? A: No, each BlueClerk account can only be linked to one Google account.

Q: What happens if I sign in with Google using an email that already has a BlueClerk account? A: You'll need to link the Google account first from your profile settings. Sign in with email/password, then link Google from Settings > Profile.

Q: My company account signup is pending approval - can I still use Google sign-in? A: Yes, but you won't have access to the dashboard until an admin approves your company account.