Embed Sign In / Up form in a page
#
Case 1: Rendering the Auth Widget in a pageThe following example shows the scenario where you have a dedicated route, such as /auth
, for rendering the Auth Widget. Upon a successful login, the user will be automatically redirected to the return value of getRedirectionURL
(defaulting to /
).
- ReactJS
- Angular
- Vue
Important
supertokens-auth-react
SDK and will inject the React components to show the UI. Therefore, the code snippet below refers to the supertokens-auth-react
SDK.Important
supertokens-auth-react
SDK and will inject the React components to show the UI. Therefore, the code snippet below refers to the supertokens-auth-react
SDK.In the above code snippet, we:
- Disabled the default Auth UI by setting
disableDefaultUI
totrue
inside the ThirdPartyEmailPassword recipe config. - Override the
getRedirectionURL
function inside the ThirdPartyEmailPassword recipe config to redirect to/dashboard
upon successful login and to redirect to/auth
when login is required.
Feel free to customize the redirection URLs as needed.
note
When the user visits the /auth
page, they will see the SignIn UI by default. To render the SignUp UI, append show=signup
as a query parameter to the URL, like/auth?show=signup
.
#
Case 2: Rendering the Auth Widget in a page with no redirectionThe following example shows the scenario where you have a dedicated route, such as /auth
, for rendering the Auth Widget. However, upon a successful login, the user will see a logged in UI instead of getting redirected.
- ReactJS
- Angular
- Vue
Important
supertokens-auth-react
SDK and will inject the React components to show the UI. Therefore, the code snippet below refers to the supertokens-auth-react
SDK.Important
supertokens-auth-react
SDK and will inject the React components to show the UI. Therefore, the code snippet below refers to the supertokens-auth-react
SDK.In the above code snippet, we wrap the logged-in component with Session.SessionAuth
to validate all claims before displaying the logged-in UI. For instance, with email verification enabled, if a user's email is unverified, Session.SessionAuth
redirects to the email verification page.
note
In the above case, redirection may occur if a claim fails. For instance, in the case of an Email Verification claim, if the user's email is not verified, they will be redirected to the email verification page. To prevent redirection for failed claims, please contact us on Discord for assistance.
#
Case 3: Rendering the Auth Widget in a popupThe following example shows the scenario where you embed the Auth Widget in a popup, and upon successful login, you aim to close the popup.
- ReactJS
- Angular
- Vue
Important
supertokens-auth-react
SDK and will inject the React components to show the UI. Therefore, the code snippet below refers to the supertokens-auth-react
SDK.Important
supertokens-auth-react
SDK and will inject the React components to show the UI. Therefore, the code snippet below refers to the supertokens-auth-react
SDK.note
In the above case, redirection may occur if a claim fails. For instance, in the case of an Email Verification claim, if the user's email is not verified, they will be redirected to the email verification page. To prevent redirection for failed claims, please contact us on Discord for assistance.