feat/DOCS-5492-Add-Universal-Components-documents

main/config/navigation/universal-components.json

@@ -1,30 +1,74 @@
 {
-  "pages": [
-    "docs/get-started/universal-components/universal-components-overview",
-    "docs/get-started/universal-components/auth0-component-provider",
-    "docs/get-started/universal-components/universal-components-style",
+  "groups": [
     {
-      "group": "My Organization",
+      "group": " ",
       "pages": [
-        "docs/get-started/universal-components/my-organization/build-delegated-admin",
+        "docs/get-started/universal-components/universal-components-overview"
+      ]
+    },
+    {
+      "group": "Web Components",
+      "icon": "globe",
+      "pages": [
+        "docs/get-started/universal-components/web/web-overview",
+        "docs/get-started/universal-components/web/auth0-component-provider",
+        "docs/get-started/universal-components/web/universal-components-style",
         {
-          "group": "Domain Management",
+          "group": "Components",
           "pages": [
-            "docs/get-started/universal-components/my-organization/domain-management/configure-org-domains"
+            {
+              "group": "My Organization",
+              "pages": [
+                "docs/get-started/universal-components/web/components/build-delegated-admin",
+                "docs/get-started/universal-components/web/components/edit-organization-details",
+                "docs/get-started/universal-components/web/components/configure-org-domains",
+                "docs/get-started/universal-components/web/components/sso-provider-table",
+                "docs/get-started/universal-components/web/components/sso-provider-create",
+                "docs/get-started/universal-components/web/components/sso-provider-edit"
+              ]
+            }
           ]
-        },
+        }
+      ]
+    },
+    {
+      "group": "iOS Components",
+      "icon": "apple",
+      "pages": [
+        "docs/get-started/universal-components/ios/ios-overview",
+        "docs/get-started/universal-components/ios/ios-theming",
         {
-          "group": "IDP Management",
+          "group": "Components",
           "pages": [
-            "docs/get-started/universal-components/my-organization/idp-management/sso-provider-table",
-            "docs/get-started/universal-components/my-organization/idp-management/sso-provider-create",
-            "docs/get-started/universal-components/my-organization/idp-management/sso-provider-edit"
+            {
+              "group": "My Account",
+              "pages": [
+                "docs/get-started/universal-components/ios/components/my-account-overview",
+                "docs/get-started/universal-components/ios/components/auth-methods-management",
+                "docs/get-started/universal-components/ios/components/factors/passkeys"
+              ]
+            }
           ]
-        },
+        }
+      ]
+    },
+    {
+      "group": "Android Components",
+      "icon": "android",
+      "pages": [
+        "docs/get-started/universal-components/android/android-overview",
+        "docs/get-started/universal-components/android/android-theming",
         {
-          "group": "Organization Management",
+          "group": "Components",
           "pages": [
-            "docs/get-started/universal-components/my-organization/organization-management/edit-organization-details"
+            {
+              "group": "My Account",
+              "pages": [
+                "docs/get-started/universal-components/android/components/my-account-overview",
+                "docs/get-started/universal-components/android/components/auth-methods-management",
+                "docs/get-started/universal-components/android/components/factors/passkeys"
+              ]
+            }
           ]
         }
       ]

main/config/redirects.json

@@ -22670,5 +22670,65 @@
   {
     "source": "/docs/manage-users/user-migration/user-import-export-extension",
     "destination": "/docs/manage-users/user-migration/bulk-user-import-export"
+  },
+  {
+    "source": "/docs/get-started/universal-components/auth0-component-provider",
+    "destination": "/docs/get-started/universal-components/web/auth0-component-provider"
+  },
+  {
+    "source": "/docs/get-started/universal-components/universal-components-style",
+    "destination": "/docs/get-started/universal-components/web/universal-components-style"
+  },
+  {
+    "source": "/docs/get-started/universal-components/webfoundations/auth0-component-provider",
+    "destination": "/docs/get-started/universal-components/web/auth0-component-provider"
+  },
+  {
+    "source": "/docs/get-started/universal-components/webfoundations/universal-components-style",
+    "destination": "/docs/get-started/universal-components/web/universal-components-style"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-organization/build-delegated-admin",
+    "destination": "/docs/get-started/universal-components/web/components/build-delegated-admin"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-organization/organization-management/edit-organization-details",
+    "destination": "/docs/get-started/universal-components/web/components/edit-organization-details"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-organization/domain-management/configure-org-domains",
+    "destination": "/docs/get-started/universal-components/web/components/configure-org-domains"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-organization/idp-management/sso-provider-table",
+    "destination": "/docs/get-started/universal-components/web/components/sso-provider-table"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-organization/idp-management/sso-provider-create",
+    "destination": "/docs/get-started/universal-components/web/components/sso-provider-create"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-organization/idp-management/sso-provider-edit",
+    "destination": "/docs/get-started/universal-components/web/components/sso-provider-edit"
+  },
+  {
+    "source": "/docs/get-started/universal-components/native-foundations/native-overview",
+    "destination": "/docs/get-started/universal-components/ios/ios-overview"
+  },
+  {
+    "source": "/docs/get-started/universal-components/native-foundations/native-theming",
+    "destination": "/docs/get-started/universal-components/ios/ios-theming"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-account/my-account-overview",
+    "destination": "/docs/get-started/universal-components/ios/components/my-account-overview"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-account/auth-methods-management",
+    "destination": "/docs/get-started/universal-components/ios/components/auth-methods-management"
+  },
+  {
+    "source": "/docs/get-started/universal-components/my-account/factors/passkeys",
+    "destination": "/docs/get-started/universal-components/ios/components/factors/passkeys"
   }
 ]

main/docs/authenticate/database-connections/passkeys/native-passkeys-for-mobile-applications.mdx

@@ -55,7 +55,7 @@ For end users to authenticate with a single passkey with across different applic
 
 1. Navigate to [Applications > Applications](https://manage.auth0.com/#/applications) and select the application you wish to update.
 2. At the bottom of the Settings tab, select **Advanced Settings**. Then, choose the **Device Settings** tab.
-3. Complete the **iOS** and **Android** sections as needed for your application. Then, click **Save Changes**.
+3. Complete the **iOS** or **Android** sections as needed for your application. Then, click **Save Changes**.
 4. In the Advanced Settings section, select the **Grant Types** tab.
 5. Enable the **Passkey** grant, then select **Save Changes**.
 

main/docs/get-started/universal-components/android/android-overview.mdx

@@ -0,0 +1,99 @@
+---
+title: Universal Components for Android Applications
+description: Learn how to install and configure Auth0 Universal Components for Android applications.
+sidebarTitle: Install and Configure Universal Components
+---
+
+import { ReleaseStageNotice } from "/snippets/ReleaseStageNotice.jsx"
+
+<ReleaseStageNotice
+    feature="Auth0 Universal Components"
+    stage="beta"
+    terms="true"
+    contact="Auth0 Support"
+/>
+
+The Auth0 [Universal Components for Android](https://github.com/auth0/ui-components-android) SDK provides pre-built, embeddable UI for Auth0 identity flows using [Jetpack Compose](https://developer.android.com/compose).
+
+Universal Components for Android are built on top of the [Auth0 Android SDK](https://github.com/auth0/Auth0.Android) and integrate with [My Account APIs](/docs/manage-users/my-account-api).
+
+## Prerequisites
+
+To configure the Universal Components for Android SDK, you need:
+
+* Operating systems: **Android 11+** (API 30).
+* Programming language: **Kotlin 2.2+**, **Android Gradle Plugin 8.11+**, **Jetpack Compose BOM 2024.09.00+**, **JDK 17+**.
+
+
+<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
+To enable Auth0 [passkey](/docs/authenticate/database-connections/passkeys) support, you need **Android 14+**.
+ </Callout>
+
+## Install the SDK
+
+The Universal Components for Android SDK is distributed as the `com.auth0.universalcomponents:universal-components` package through the [Maven Central](https://mvnrepository.com/artifact/com.auth0) repository.
+
+### Gradle
+
+Use Gradle to install the SDK:
+
+1. Add the `mavenCentral()` repository if it is not listed in your `settings.gradle` or `settings.gradle.kts` file:
+
+    ```kotlin
+    dependencyResolutionManagement {
+        repositories {
+            mavenCentral()
+            google()
+        }
+    }
+    ```
+
+2. Add the dependency to your module-level `build.gradle` or `build.gradle.kts`:
+
+    ```kotlin
+    dependencies {
+        implementation("com.auth0.universalcomponents:universal-components:1.0.0-beta.0")
+    }
+    ```
+
+<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
+Auth0 recommends using [Auth0.Android v3+](https://github.com/auth0/Auth0.Android) in your application. Older versions may cause compilation errors when resolved alongside Universal Components.
+</Callout>
+
+
+### Configure Compose
+
+Ensure [Compose](https://developer.android.com/develop/ui/compose/setup-compose-dependencies-and-compiler#setup-compose-dependencies) is enabled in your application's `build.gradle` file:
+
+```kotlin wrap lines
+android {
+    buildFeatures {
+        compose = true
+    }
+}
+```
+
+### Verify the installation
+
+To verify the Universal Components for Android SDK installation, confirm the dependency resolves by running:
+
+```bash wrap lines
+./gradlew app:dependencies | grep universal-components
+```
+
+## Sample application
+
+You can review the sample application of the [Universal Components for Android](https://github.com/auth0/ui-components-android#run-the-sample-app) SDK on GitHub.
+
+The sample application includes `MainActivity.kt` that initializes the SDK using `Auth0UniversalComponents.initialize()` and `LoginSecurityScreen.kt` that renders the `AuthenticatorSettingsComponent`.
+
+## Next steps
+<CardGroup cols={2}>
+  <Card title="Customize style and themes" icon="palette" href="/docs/get-started/universal-components/android/android-theming">
+    Override colors, typography, spacing, radius, and size tokens using the Auth0 design-token system.
+  </Card>
+
+  <Card title="Build a Self-Service Account Security Interface" icon="key" href="/docs/get-started/universal-components/android/components/my-account-overview">
+    Prepare your Auth0 tenant, initialize the SDK, and render the authentication-methods management UI.
+  </Card>
+</CardGroup>