Skip to content

Conversation

@chriscanin
Copy link
Contributor

@chriscanin chriscanin commented Nov 12, 2025

🔎 Previews:

What does this solve?

  • Adds comprehensive documentation for developers implementing native Google Sign-In in their Expo apps
  • Provides step-by-step setup instructions for configuring Google OAuth credentials and Clerk integration
  • Documents the new useSignInWithGoogle() hook API, parameters, return values, and error handling

Files Added:

  • docs/reference/expo/use-google-sign-in.mdx - Complete API reference for the useSignInWithGoogle() hook
  • docs/guides/configure/auth-strategies/sign-in-with-google.expo.mdx - Comprehensive setup guide for Google Sign-In

What changed?

  • Added API Reference Documentation: Created complete reference for useSignInWithGoogle() hook including:

    • Method signature with TypeScript types
    • Return value descriptions (createdSessionId, setActive, signIn, signUp)
    • Three practical examples: basic usage, with custom metadata, and reusable component
    • Comprehensive error handling guide covering user cancellation, platform errors, missing packages, and Play Services issues
  • Added Setup Guide: Created detailed setup guide covering:

    • Google Cloud Console configuration (creating Web, iOS, and Android OAuth 2.0 credentials)
    • SHA-1 certificate fingerprint generation for Android debug and release builds
    • Adding iOS and Android apps to Clerk Dashboard Native Applications
    • Enabling Google as an SSO connection in Clerk
    • Environment variable configuration for client IDs
    • App config integration with proper expo plugin setup
    • Build requirements and instructions (prebuild vs EAS Build)

Checklist

  • I have clicked on "Files changed" and performed a thorough self-review
  • All existing checks pass

@vercel
Copy link

vercel bot commented Nov 12, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Updated (UTC)
clerk-docs Ready Ready Preview Nov 26, 2025 6:36pm

@chriscanin chriscanin marked this pull request as ready for review November 13, 2025 22:05
@chriscanin chriscanin requested a review from a team as a code owner November 13, 2025 22:05
@SarahSoutoul
Copy link
Contributor

@chriscanin have pushed my docs review here - let me know your thoughts. Feel free to put it back in draft as we discussed if it needs to be retweaked. A lot of the changes I submitted are consistency + docs voice changes.

…ble names and remove outdated package reference
@SarahSoutoul
Copy link
Contributor

@chriscanin have left the second docs review after your recent changes: docs review pt 2 after changes. Have a look and let me know your thoughts.

I want to double check a few more things and test out the flow, and then it should be good.

1. For the **Application type**, select **Web application**.
1. Add a name (e.g., "Web client for token verification").
1. Select **Create**. A modal will open with your **Client ID**.
1. Copy and save the **Client ID** - you'll need this for `EXPO_PUBLIC_CLERK_GOOGLE_WEB_CLIENT_ID`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

## Add your Android application to Clerk

Add your Android application to the [**Native Applications**](https://dashboard.clerk.com/~/native-applications) page in the Clerk Dashboard. You will need your Android app's **package name**.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this step not needed? Like in the Android guide. @chriscanin

Screenshot 2025-11-26 at 1 57 15 pm

1. Select **Add connection** and select **For all users**.
1. In the **Choose provider** dropdown, select **Google**.
1. Ensure that both **Enable for sign-up and sign-in** and **Use custom credentials** are toggled on.
1. Save the **Authorized Redirect URI** somewhere secure. Keep this modal and page open.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is being saved, but where do we actually use it? @chriscanin

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants