[DO MERGE] Sign-in-or-up docs

docs/authentication/configuration/legal-compliance.mdx

@@ -3,7 +3,7 @@ title: Legal compliance
 description: Learn how to configure your legal compliance settings in the Clerk Dashboard.
 ---
 
-Clerk provides a legal compliance setting that allows you to require users to agree to your terms of service or privacy policy before they can sign up to your application. After enabling the setting, there will be a checkbox to accept the terms in your [`<SignUp />` component](/docs/components/authentication/sign-up) or [Account Portal sign-up page](/docs/customization/account-portal/overview#sign-up).
+Clerk provides a legal compliance setting that allows you to require users to agree to your terms of service or privacy policy before they can sign up to your application. After enabling the setting, there will be a checkbox to accept the terms in your [`<SignUp />` component](/docs/components/authentication/sign-up) or [Account Portal sign-up page](/docs/customization/account-portal/overview#sign-in-or-up).
 
 To configure the setting:
 

docs/components/authentication/sign-in.mdx

@@ -5,7 +5,7 @@ description: Clerk's <SignIn /> component renders a UI for signing in users.
 
 ![The \<SignIn /> component renders a UI for signing in users.](/docs/images/ui-components/sign-in.png){{ style: { maxWidth: '460px' } }}
 
-The `<SignIn />` component renders a UI for signing in users. The functionality of the `<SignIn />` component 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/authentication/configuration/sign-up-sign-in-options) and [social connections](/docs/authentication/social-connections/overview). You can further customize your `<SignIn />` component by passing additional [properties](#properties) at the time of rendering.
+The `<SignIn />` component renders a UI to allow users to sign in or sign up by default. The functionality of the `<SignIn />` component 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/authentication/configuration/sign-up-sign-in-options) and [social connections](/docs/authentication/social-connections/overview). You can further customize your `<SignIn />` component by passing additional [properties](#properties) at the time of rendering.
 
 > [!NOTE]
 > The `<SignUp/>` and `<SignIn/>` components cannot render when a user is already signed in, unless the application allows multiple sessions. If a user is already signed in and the application only allows a single session, Clerk will redirect the user to the Home URL instead.
@@ -92,6 +92,13 @@ All props are optional.
 
   ---
 
+  - `withSignUp?`
+  - `boolean`
+
+  Opt into sign-in-or-up flow by setting this prop to `true`. Defaults to `false`. When true, if a user does not exist, they will be prompted to sign up. If a user exists, they will be prompted to sign in.
+
+  ---
+
   - `fallback?`
   - `ReactNode`
 
@@ -106,7 +113,7 @@ The following example includes basic implementation of the `<SignIn />` componen
   <Tab>
     The following example demonstrates how you can use the `<SignIn />` component on a public page.
 
-    If you would like to create a dedicated `/sign-in` page in your Next.js application, see the [dedicated guide](/docs/references/nextjs/custom-signup-signin-pages).
+    If you would like to create a dedicated `/sign-in` page in your Next.js application, see the [dedicated guide](/docs/references/nextjs/custom-sign-in-or-up-page).
 
     ```tsx {{ filename: 'app/page.tsx' }}
     import { SignIn, useUser } from '@clerk/nextjs'

docs/components/authentication/sign-up.mdx

@@ -99,7 +99,7 @@ The following example includes basic implementation of the `<SignUp />` componen
   <Tab>
     The following example demonstrates how you can use the `<SignUp />` component on a public page.
 
-    If you would like to create a dedicated `/sign-up` page in your Next.js application, see the [dedicated guide](/docs/references/nextjs/custom-signup-signin-pages).
+    If you would like to create a dedicated `/sign-up` page in your Next.js application, see the [dedicated guide](/docs/references/nextjs/custom-sign-up-page).
 
     ```tsx {{ filename: 'app/page.tsx' }}
     import { SignUp, useUser } from '@clerk/nextjs'

docs/custom-flows/embedded-email-links.mdx

@@ -32,7 +32,7 @@ This guide will demonstrate how to generate a sign-in token and use it to sign i
     -d '{ "user_id": "user_123" }'
   ```
 
-  This will return a `url` property, which can be used as your email link. Keep in mind that this link will use the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in) to sign in the user.
+  This will return a `url` property, which can be used as your email link. Keep in mind that this link will use the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in-or-up) to sign in the user.
 
   If you would rather use your own sign-in page, you can use the `token` property that is returned. Add the `token` as a query param in any link, such as the following example:
 

docs/custom-flows/invitations.mdx

@@ -5,7 +5,7 @@ description: Learn how to use the Clerk API to build a custom flow for handling
 
 <Include src="_partials/custom-flows-callout" />
 
-When a user visits an [invitation](/docs/users/invitations) link, and no custom redirect URL was specified, then they will be redirected to the [Account Portal sign-up page](/docs/customization/account-portal/overview#sign-up) and **their email address will be automatically verified.**
+When a user visits an [invitation](/docs/users/invitations) link, and no custom redirect URL was specified, then they will be redirected to the [Account Portal sign-up page](/docs/customization/account-portal/overview#sign-in-or-up) and **their email address will be automatically verified.**
 
 However, if you specified [a redirect URL when creating the invitation](/docs/users/invitations#redirect-url), you must handle the sign-up flow in your code for that page. You can either embed the [`<SignUp />`](/docs/components/authentication/sign-up) component on that page, or if the prebuilt component doesn't meet your specific needs or if you require more control over the logic, you can rebuild the existing Clerk flows using the Clerk API.
 

docs/integrations/databases/firebase.mdx

@@ -205,7 +205,7 @@ Integrating Firebase with Clerk gives you the benefits of using Firebase's featu
 
   ---
 
-  - [Create custom sign-up and sign-in pages in your Next.js app](/docs/references/nextjs/custom-signup-signin-pages)
+  - [Create  a custom sign-in-or-up page in your Next.js app](/docs/references/nextjs/custom-sign-in-or-up-page)
   - Learn how add custom sign-up and sign-in pages with Clerk components in your Next.js application.
 
   ---

docs/manifest.json

@@ -1790,8 +1790,12 @@
                           "href": "/docs/references/nextjs/read-session-data"
                         },
                         {
-                          "title": "Add custom sign-up and sign-in pages",
-                          "href": "/docs/references/nextjs/custom-signup-signin-pages"
+                          "title": "Add a custom sign-in-or-up page",
+                          "href": "/docs/references/nextjs/custom-sign-in-or-up-page"
+                        },
+                        {
+                          "title": "Add a custom sign-up page",
+                          "href": "/docs/references/nextjs/custom-sign-up-page"
                         },
                         {
                           "title": "Add custom onboarding",
@@ -2355,8 +2359,12 @@
                           "href": "/docs/references/expo/web-support/overview"
                         },
                         {
-                          "title": "Add custom sign-up and sign-in pages",
-                          "href": "/docs/references/expo/web-support/custom-signup-signin-pages"
+                          "title": "Add a custom sign-in-or-up page",
+                          "href": "/docs/references/expo/web-support/custom-sign-in-or-up-page"
+                        },
+                        {
+                          "title": "Add a custom sign-up page",
+                          "href": "/docs/references/expo/web-support/custom-sign-up-page"
                         }
                       ]
                     ]
@@ -2447,8 +2455,12 @@
                           "href": "/docs/references/react-router/read-session-data"
                         },
                         {
-                          "title": "Add custom sign up and sign in pages",
-                          "href": "/docs/references/react-router/custom-signup-signin-pages"
+                          "title": "Add custom sign-in-or-up page",
+                          "href": "/docs/references/react-router/custom-sign-in-or-up-page"
+                        },
+                        {
+                          "title": "Add custom sign-up page",
+                          "href": "/docs/references/react-router/custom-sign-up-page"
                         },
                         {
                           "title": "Library mode",
@@ -2493,9 +2505,14 @@
                     "href": "/docs/references/remix/spa-mode"
                   },
                   {
-                    "title": "Add custom sign up and sign in pages",
+                    "title": "Add custom sign-in-or-up page",
                     "wrap": true,
-                    "href": "/docs/references/remix/custom-signup-signin-pages"
+                    "href": "/docs/references/remix/custom-sign-in-or-up-page"
+                  },
+                  {
+                    "title": "Add custom sign-up page",
+                    "wrap": true,
+                    "href": "/docs/references/remix/custom-sign-up-page"
                   },
                   {
                     "title": "Read session and user data",
@@ -2536,8 +2553,13 @@
                     "items": [
                       [
                         {
-                          "title": "Add custom sign up and sign in pages",
-                          "href": "/docs/references/tanstack-start/custom-signup-signin-pages",
+                          "title": "Add custom sign-in-or-up-page",
+                          "href": "/docs/references/tanstack-start/custom-sign-in-or-up-page",
+                          "wrap": true
+                        },
+                        {
+                          "title": "Add custom sign-up-page",
+                          "href": "/docs/references/tanstack-start/custom-sign-up-page",
                           "wrap": true
                         },
                         {

docs/organizations/accept-organization-invitations.mdx

@@ -5,7 +5,7 @@ description: Learn how to use the Clerk API to build a custom flows for handling
 
 <Include src="_partials/custom-flows-callout" />
 
-When a user visits an [organization invitation](/docs/organizations/invitations) link, and no custom redirect URL was specified, and they have an account for your application, then they will be redirected to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in). If they do not have an account for your application, they will be redirected to the [Account Portal sign-up page](/docs/customization/account-portal/overview#sign-up).
+When a user visits an [organization invitation](/docs/organizations/invitations) link, and no custom redirect URL was specified, and they have an account for your application, then they will be redirected to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in-or-up). If they do not have an account for your application, they will be redirected to the [Account Portal sign-up page](/docs/customization/account-portal/overview#sign-in-or-up).
 
 However, if you specified [a redirect URL when creating the invitation](/docs/users/invitations#redirect-url), you must handle the sign-up and sign-in flows in your code for that page. You can either embed the [`<SignIn /`>](/docs/components/authentication/sign-in) component on that page, or if the prebuilt component doesn't meet your specific needs or if you require more control over the logic, you can rebuild the existing Clerk flows using the Clerk API.
 

docs/organizations/invitations.mdx

@@ -5,7 +5,7 @@ description: Learn how to invite users to your organization.
 
 Organization invitations allow you to add new members to your organization, granting them access to organization-specific features and resources.
 
-Once you create an invitation, Clerk sends an email to the invited user with a unique invitation link. When the user visits the organization invitation link, they will be redirected to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in). If the user is already signed in, they will be redirected to your application's homepage (`/`). If you want to redirect the user to a specific page in your application, you can [specify a redirect URL when creating the invitation](#redirect-url).
+Once you create an invitation, Clerk sends an email to the invited user with a unique invitation link. When the user visits the organization invitation link, they will be redirected to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in-or-up). If the user is already signed in, they will be redirected to your application's homepage (`/`). If you want to redirect the user to a specific page in your application, you can [specify a redirect URL when creating the invitation](#redirect-url).
 
 ## Create an invitation
 

docs/quickstarts/astro.mdx

@@ -112,7 +112,7 @@ description: Add authentication and user management to your Astro app with Clerk
   - [`<SignedIn>`](/docs/components/control/signed-in): Children of this component can only be seen while **signed in**.
   - [`<SignedOut>`](/docs/components/control/signed-out): Children of this component can only be seen while **signed out**.
   - [`<UserButton />`](/docs/components/user/user-button): Shows the signed-in user's avatar. Selecting it opens a dropdown menu with account management options.
-  - [`<SignInButton />`](/docs/components/unstyled/sign-in-button): An unstyled component that links to the sign-in page. In this example, since no props or [environment variables](/docs/deployments/clerk-environment-variables) are set for the sign-in URL, this component links to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in).
+  - [`<SignInButton />`](/docs/components/unstyled/sign-in-button): An unstyled component that links to the sign-in page. In this example, since no props or [environment variables](/docs/deployments/clerk-environment-variables) are set for the sign-in URL, this component links to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in-or-up).
 
   ```astro {{ filename: 'src/layouts/SiteLayout.astro' }}
   ---

docs/quickstarts/nextjs.mdx

@@ -104,7 +104,7 @@ description: Add authentication and user management to your Next.js app with Cle
   - [`<SignedIn>`](/docs/components/control/signed-in): Children of this component can only be seen while **signed in**.
   - [`<SignedOut>`](/docs/components/control/signed-out): Children of this component can only be seen while **signed out**.
   - [`<UserButton />`](/docs/components/user/user-button): Shows the signed-in user's avatar. Selecting it opens a dropdown menu with account management options.
-  - [`<SignInButton />`](/docs/components/unstyled/sign-in-button): An unstyled component that links to the sign-in page. In this example, since no props or [environment variables](/docs/deployments/clerk-environment-variables) are set for the sign-in URL, this component links to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in).
+  - [`<SignInButton />`](/docs/components/unstyled/sign-in-button): An unstyled component that links to the sign-in page. In this example, since no props or [environment variables](/docs/deployments/clerk-environment-variables) are set for the sign-in URL, this component links to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in-or-up).
 
   Select your preferred router to learn how to make this data available across your entire app:
 
@@ -186,8 +186,8 @@ description: Add authentication and user management to your Next.js app with Cle
 
   ---
 
-  - [Create custom sign-up and sign-in pages](/docs/references/nextjs/custom-signup-signin-pages)
-  - Learn how add custom sign-up and sign-in pages with Clerk components.
+  - [Create a custom sign-in or sign-up page](/docs/references/nextjs/custom-sign-in-or-up-page)
+  - Learn how add a custom sign-in or sign-up page with Clerk components.
 
   ---
 

docs/quickstarts/react-router.mdx

@@ -227,8 +227,8 @@ This guide assumes that you're using [React Router v7 or later](https://api.reac
 ## Next steps
 
 <Cards>
-  - [Add custom sign-up and sign-in pages](/docs/references/react-router/custom-signup-signin-pages)
-  - Learn how to add custom sign-up and sign-in pages to your React Router app with Clerk's prebuilt components.
+  - [Create a custom sign-in-or-up page](/docs/references/react-router/custom-sign-in-or-up-page)
+  - Learn how add custom sign-in-or-up page with Clerk components.
 
   ---
 

docs/quickstarts/remix.mdx

@@ -197,7 +197,7 @@ Learn how to use Clerk to quickly and easily add secure authentication and user
   - [`<SignedIn>`](/docs/components/control/signed-in): Children of this component can only be seen while **signed in**.
   - [`<SignedOut>`](/docs/components/control/signed-out): Children of this component can only be seen while **signed out**.
   - [`<UserButton />`](/docs/components/user/user-button): Shows the signed-in user's avatar. Selecting it opens a dropdown menu with account management options.
-  - [`<SignInButton />`](/docs/components/unstyled/sign-in-button): An unstyled component that links to the sign-in page. In this example, since no props or [environment variables](/docs/deployments/clerk-environment-variables) are set for the sign-in URL, this component links to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in)
+  - [`<SignInButton />`](/docs/components/unstyled/sign-in-button): An unstyled component that links to the sign-in page. In this example, since no props or [environment variables](/docs/deployments/clerk-environment-variables) are set for the sign-in URL, this component links to the [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in-or-up)
 
   ```tsx {{ filename: 'routes/_index.tsx' }}
   import {
@@ -280,8 +280,8 @@ Learn how to use Clerk to quickly and easily add secure authentication and user
 ## Next steps
 
 <Cards>
-  - [Create custom sign-up and sign-in pages](/docs/references/remix/custom-signup-signin-pages)
-  - Learn how add custom sign-up and sign-in pages with Clerk components.
+  - [Create a custom sign-in-or-up page](/docs/references/remix/custom-sign-in-or-up-page)
+  - Learn how add custom sign-in-or-up page with Clerk components.
 
   ---