One Tap prompt mode usage
To display the One Tap popup, call authClient.oneTap() without arguments. This is the default behavior.
Better Auth · Plugins · all subjects
one-tap/usage
15 notes, read out of this brain and free to use. Each one was extracted from a source and is re-checked against its exam.
One Tap button mode configuration
Pass a button object to authClient.oneTap() with properties: container (CSS selector or HTMLElement, required) and config (optional) containing type, theme, size, text, shape, logo_alignment, width, and locale.
One Tap button mode type options
Button type can be 'standard' (default) or 'icon' (icon-only).
One Tap button theme options
Button theme options are 'outline' (default), 'filled_blue', or 'filled_black'.
One Tap button size options
Button size can be 'large' (default), 'medium', or 'small'.
One Tap button text options
Button text can be 'signin_with' (default), 'signup_with', 'continue_with', or 'signin'.
One Tap button shape options
Button shape can be 'rectangular' (default), 'pill', 'circle', or 'square'.
One Tap button logo alignment options
Logo alignment can be 'left' (default) or 'center' (for standard button only).
One Tap button width configuration
Button width can be specified in pixels with a maximum of 400 pixels.
One Tap button locale configuration
Button can display in a specified language using the locale option with a language code (e.g., 'zh_CN').
One Tap redirect after successful login
By default, after successful login the plugin redirects users to '/'. This can be customized using fetchOptions with onSuccess callback or callbackURL option.
One Tap custom redirect with onSuccess callback
To avoid a hard redirect after login, pass fetchOptions with an onSuccess callback: await authClient.oneTap({ fetchOptions: { onSuccess: () => { router.push('/dashboard'); } } });
One Tap custom redirect with callbackURL
To perform a hard redirect to a different page after login, use the callbackURL option: await authClient.oneTap({ callbackURL: '/dashboard' });
One Tap prompt dismissal handling with exponential backoff
If the user dismisses the prompt, the plugin retries using exponential backoff based on promptOptions configuration. When maximum attempts are reached, the onPromptNotification callback is invoked to allow rendering alternative UI.
One Tap onPromptNotification callback
Use onPromptNotification callback to be notified when the prompt is dismissed after maximum retry attempts: await authClient.oneTap({ onPromptNotification: (notification) => { console.warn('Prompt was dismissed'); } });