Skip to main content

Login Page

Customising Text​

Change the labels, placeholder text, and button copy without replacing the component:

authConfig={{
login: {
title: 'Welcome Back',
subtitle: 'Sign in to your account',
submitButtonText: 'Sign In',
showRememberMe: true,
defaultTab: 'email', // 'email' or 'mobile'
formLabels: {
email: 'Email Address',
password: 'Password',
},
formPlaceholders: {
email: 'you@example.com',
password: '••••••••',
},
},
}}

Redirect After Login​

By default users are redirected based on their role's configured landing route. To override:

authConfig={{
login: {
redirectAfterLogin: '/app/dashboard',
},
}}

Replacing the Login Page​

To build a completely custom login experience, pass a LoginPage component:

import CustomLogin from './custom/pages/CustomLogin';

authConfig={{
customComponents: {
LoginPage: CustomLogin,
},
}}

Your CustomLogin receives standard React props. You're responsible for calling the Zango auth API and handling the redirect.

Replacing Just the Login Card​

To keep the page layout but swap only the card:

authConfig={{
customComponents: {
LoginCard: MyCustomCard,
},
}}

Role Selection Page​

When a user has multiple roles, a role selection screen appears after login. Customise its text:

authConfig={{
roleSelection: {
title: 'Choose your role',
subtitle: 'Select the role to continue with',
continueButtonText: 'Continue',
gridColumns: 2, // 2 or 3
},
}}

Two-Factor Auth Page​

authConfig={{
twoFactor: {
title: 'Verify your identity',
subtitle: 'Enter the code sent to your device',
codeLength: 6,
resendCountdown: 60,
submitButtonText: 'Verify',
},
}}