Merge pull request #1048 from supertokens/feat/tenant-management-docs

Add information about the origin property

Author: bcbogdan

docs/quickstart/backend-setup.mdx

@@ -110,6 +110,18 @@ The init call will include [configuration details](/docs/references/backend-sdks
   </BackendTabs.TabItem>
 </BackendTabs>
 
+
+:::info Multiple frontend domains
+To handle clients from different domains with the same SuperTokens instance, use the `origin` property in the `appInfo` object instead of `websiteDomain`.
+The property accepts a function that receives the original request as an input and should return a valid domain.
+Make sure to whitelist all the domains during CORS configuration.
+
+Keep in mind that with this setup, each frontend application will not share authentication sessions.
+Users will have to authenticate separately for each domain.
+To configure a shared authentication experiece between multiple services check the [Unified Login](/docs/authentication/unified-login/introduction) documentation.
+:::
+
+
 ## 3. Add the SuperTokens APIs and Configure CORS
 
 Now that the SDK is initialized you need to expose the endpoints that will be used by the frontend SDKs.

docs/references/backend-sdks/reference.mdx

@@ -74,9 +74,10 @@ The `appInfo` object is the paramter used to configure the SDKs during initializ
 ```ts
 let appInfo: {
     appName: string,
-    websiteDomain: string,
     apiDomain: string,
+    websiteDomain?: string,
     websiteBasePath?: string,  
+    origin?: ((input: { request?: Request; userContext: UserContext }) => string) | string,  
     apiBasePath?: string,  
     apiGatewayPath?: string 
 }
@@ -133,6 +134,13 @@ Remember to set the same value for this parameter on the backend and the fronten
 
 <br/>
 
+## `origin`
+
+Can be used instead of `websiteDomain` to handle multiple frontend domains within the same SuperTokens instance.
+The property accepts a function that receives the original request as an input and should return a valid domain.
+Make sure to whitelist all the domains during CORS configuration.
+
+<br/>
 
 ## `apiBasePath`