Skip to content

Conversation

@swolfand
Copy link
Contributor

@swolfand swolfand commented Dec 1, 2025

🔎 Previews:

This pull request adds comprehensive documentation for Clerk's Android UI components and customization options. It introduces reference pages for the main Clerk Android views, explains how to customize them using the new ClerkTheme system, and clarifies installation and usage patterns for the Clerk Android SDK. The changes are grouped into new documentation for Android views, detailed theming and customization guides, and updates to component reference listings.

Android Views Documentation

  • Added new reference pages for Clerk Android views: AuthView, UserButton, and UserProfileView, including usage examples, parameter descriptions, and customization instructions. [1] [2] [3]
  • Introduced an overview page for Clerk Android views, listing available components and providing installation instructions for the SDK packages.

Theming and Customization

  • Added a dedicated guide for customizing Clerk Android views using the ClerkTheme, detailing color, typography, and design properties, as well as usage examples for global and per-view theming.
  • Included a partial describing how to rebuild Clerk flows for advanced customization and linking to custom flow guides.

Component Reference Updates

  • Updated the main component reference to remove android from the SDK list, ensuring correct categorization and navigation.

What does this solve?

What changed?

Checklist

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

@swolfand swolfand requested a review from a team as a code owner December 1, 2025 21:32
@vercel
Copy link

vercel bot commented Dec 1, 2025

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

Project Deployment Preview Updated (UTC)
clerk-docs Error Error Dec 3, 2025 4:02pm

@github-actions
Copy link
Contributor

github-actions bot commented Dec 1, 2025

⚠️ Changes found in the following quickstarts:

  • android.mdx

⚠️ Please update the corresponding quickstarts in the Dashboard

@swolfand swolfand force-pushed the sam/mobile-325-android-authview-guide branch from 6620a5b to 169ed35 Compare December 1, 2025 21:35
@swolfand swolfand marked this pull request as draft December 1, 2025 21:35
@github-actions
Copy link
Contributor

github-actions bot commented Dec 1, 2025

⚠️ Changes found in the following quickstarts:

  • android.mdx

⚠️ Please update the corresponding quickstarts in the Dashboard

@github-actions
Copy link
Contributor

github-actions bot commented Dec 1, 2025

⚠️ Changes found in the following quickstarts:

  • android.mdx

⚠️ Please update the corresponding quickstarts in the Dashboard

@swolfand swolfand force-pushed the sam/mobile-325-android-authview-guide branch from 097ff9e to d5f5109 Compare December 2, 2025 23:33
@github-actions
Copy link
Contributor

github-actions bot commented Dec 2, 2025

⚠️ Changes found in the following quickstarts:

  • android.mdx

⚠️ Please update the corresponding quickstarts in the Dashboard

@github-actions
Copy link
Contributor

github-actions bot commented Dec 2, 2025

⚠️ Changes found in the following quickstarts:

  • android.mdx

⚠️ Please update the corresponding quickstarts in the Dashboard

![The AuthView renders a comprehensive authentication interface that handles both user sign-in and sign-up flows.](/docs/images/ui-components/android-auth-view.png){{ style: { maxWidth: '460px' } }}

The `AuthView` renders a comprehensive authentication interface with support for multiple sign-up flows and sign-in methods, multi-factor authentication, password reset, and account recovery. The functionality of the `AuthView` is controlled by the instance settings you specify in the [Clerk Dashboard](https://dashboard.clerk.com), such as [sign-in and sign-up options](/docs/guides/configure/auth-strategies/sign-up-sign-in-options) and [social connections](/docs/guides/configure/auth-strategies/social-connections/all-providers).
By default, the `AuthView` will automatically determine whether to sign users in or sign them up based on whether they already have an account. This is the default mode that provides seamless authentication without requiring users to choose between sign-in and sign-up.
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 specific to Android? Can't see this in the iOS AuthView page?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

iOS does this as well you can see it in signInOrUp mode in ios

Copy link
Contributor

Choose a reason for hiding this comment

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

So we should prob add it to the iOS guide too @swolfand ?

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