From 0d0eed34fc25602ad709487ebce744816174f5e8 Mon Sep 17 00:00:00 2001 From: Hazel Virdo Date: Wed, 27 May 2026 12:33:03 -0400 Subject: [PATCH 1/2] fix quickstart links/nav and build warnings --- main/config/navigation/quickstarts.json | 74 +++++++++---------- .../quickstart/backend/golang/interactive.mdx | 14 ---- .../quickstart/backend/golang/interactive.mdx | 13 ---- .../index.mdx => aspnet-core-webapi.mdx} | 0 .../{fastapi/index.mdx => fastapi.mdx} | 0 .../backend/{golang/index.mdx => golang.mdx} | 0 .../backend/{nodejs/index.mdx => nodejs.mdx} | 0 .../index.mdx => android-facebook-login.mdx} | 0 .../native/{android/index.mdx => android.mdx} | 0 .../native/{flutter/index.mdx => flutter.mdx} | 0 .../index.mdx => ionic-angular.mdx} | 0 .../index.mdx => ionic-react.mdx} | 0 .../{ionic-vue/index.mdx => ionic-vue.mdx} | 0 ...index.mdx => ios-swift-facebook-login.mdx} | 0 .../{ios-swift/index.mdx => ios-swift.mdx} | 0 .../native/{maui/index.mdx => maui.mdx} | 0 .../index.mdx => react-native-expo.mdx} | 0 .../index.mdx => react-native.mdx} | 0 .../index.mdx => windows-uwp-csharp.mdx} | 0 .../index.mdx => wpf-winforms.mdx} | 0 .../spa/{angular/index.mdx => angular.mdx} | 0 .../spa/{capn-web/index.mdx => capn-web.mdx} | 0 .../spa/{flutter/index.mdx => flutter.mdx} | 0 .../spa/{react/index.mdx => react.mdx} | 0 .../spa/{svelte/index.mdx => svelte.mdx} | 0 .../{vanillajs/index.mdx => vanillajs.mdx} | 0 .../spa/{vuejs/index.mdx => vuejs.mdx} | 0 ...ndex.mdx => aspnet-core-blazor-server.mdx} | 0 .../index.mdx => aspnet-core.mdx} | 0 .../index.mdx => aspnet-owin.mdx} | 0 .../webapp/{express/index.mdx => express.mdx} | 0 .../webapp/{fastapi/index.mdx => fastapi.mdx} | 0 .../webapp/{fastify/index.mdx => fastify.mdx} | 0 .../webapp/{hono/index.mdx => hono.mdx} | 0 .../webapp/{java-ee/index.mdx => java-ee.mdx} | 0 .../index.mdx => java-spring-boot.mdx} | 0 .../webapp/{java/index.mdx => java.mdx} | 0 .../webapp/{nextjs/index.mdx => nextjs.mdx} | 0 .../webapp/{nuxt/index.mdx => nuxt.mdx} | 0 .../webapp/{python/index.mdx => python.mdx} | 0 40 files changed, 37 insertions(+), 64 deletions(-) rename main/docs/quickstart/backend/{aspnet-core-webapi/index.mdx => aspnet-core-webapi.mdx} (100%) rename main/docs/quickstart/backend/{fastapi/index.mdx => fastapi.mdx} (100%) rename main/docs/quickstart/backend/{golang/index.mdx => golang.mdx} (100%) rename main/docs/quickstart/backend/{nodejs/index.mdx => nodejs.mdx} (100%) rename main/docs/quickstart/native/{android-facebook-login/index.mdx => android-facebook-login.mdx} (100%) rename main/docs/quickstart/native/{android/index.mdx => android.mdx} (100%) rename main/docs/quickstart/native/{flutter/index.mdx => flutter.mdx} (100%) rename main/docs/quickstart/native/{ionic-angular/index.mdx => ionic-angular.mdx} (100%) rename main/docs/quickstart/native/{ionic-react/index.mdx => ionic-react.mdx} (100%) rename main/docs/quickstart/native/{ionic-vue/index.mdx => ionic-vue.mdx} (100%) rename main/docs/quickstart/native/{ios-swift-facebook-login/index.mdx => ios-swift-facebook-login.mdx} (100%) rename main/docs/quickstart/native/{ios-swift/index.mdx => ios-swift.mdx} (100%) rename main/docs/quickstart/native/{maui/index.mdx => maui.mdx} (100%) rename main/docs/quickstart/native/{react-native-expo/index.mdx => react-native-expo.mdx} (100%) rename main/docs/quickstart/native/{react-native/index.mdx => react-native.mdx} (100%) rename main/docs/quickstart/native/{windows-uwp-csharp/index.mdx => windows-uwp-csharp.mdx} (100%) rename main/docs/quickstart/native/{wpf-winforms/index.mdx => wpf-winforms.mdx} (100%) rename main/docs/quickstart/spa/{angular/index.mdx => angular.mdx} (100%) rename main/docs/quickstart/spa/{capn-web/index.mdx => capn-web.mdx} (100%) rename main/docs/quickstart/spa/{flutter/index.mdx => flutter.mdx} (100%) rename main/docs/quickstart/spa/{react/index.mdx => react.mdx} (100%) rename main/docs/quickstart/spa/{svelte/index.mdx => svelte.mdx} (100%) rename main/docs/quickstart/spa/{vanillajs/index.mdx => vanillajs.mdx} (100%) rename main/docs/quickstart/spa/{vuejs/index.mdx => vuejs.mdx} (100%) rename main/docs/quickstart/webapp/{aspnet-core-blazor-server/index.mdx => aspnet-core-blazor-server.mdx} (100%) rename main/docs/quickstart/webapp/{aspnet-core/index.mdx => aspnet-core.mdx} (100%) rename main/docs/quickstart/webapp/{aspnet-owin/index.mdx => aspnet-owin.mdx} (100%) rename main/docs/quickstart/webapp/{express/index.mdx => express.mdx} (100%) rename main/docs/quickstart/webapp/{fastapi/index.mdx => fastapi.mdx} (100%) rename main/docs/quickstart/webapp/{fastify/index.mdx => fastify.mdx} (100%) rename main/docs/quickstart/webapp/{hono/index.mdx => hono.mdx} (100%) rename main/docs/quickstart/webapp/{java-ee/index.mdx => java-ee.mdx} (100%) rename main/docs/quickstart/webapp/{java-spring-boot/index.mdx => java-spring-boot.mdx} (100%) rename main/docs/quickstart/webapp/{java/index.mdx => java.mdx} (100%) rename main/docs/quickstart/webapp/{nextjs/index.mdx => nextjs.mdx} (100%) rename main/docs/quickstart/webapp/{nuxt/index.mdx => nuxt.mdx} (100%) rename main/docs/quickstart/webapp/{python/index.mdx => python.mdx} (100%) diff --git a/main/config/navigation/quickstarts.json b/main/config/navigation/quickstarts.json index 461ccc25af..ceec0f19fb 100644 --- a/main/config/navigation/quickstarts.json +++ b/main/config/navigation/quickstarts.json @@ -5,71 +5,71 @@ { "group": "Single Page App", "pages": [ - "docs/quickstart/spa/react/index", - "docs/quickstart/spa/angular/index", - "docs/quickstart/spa/vanillajs/index", - "docs/quickstart/spa/capn-web/index", - "docs/quickstart/spa/vuejs/index", - "docs/quickstart/spa/flutter/index", - "docs/quickstart/spa/svelte/index" + "docs/quickstart/spa/react", + "docs/quickstart/spa/angular", + "docs/quickstart/spa/vanillajs", + "docs/quickstart/spa/capn-web", + "docs/quickstart/spa/vuejs", + "docs/quickstart/spa/flutter", + "docs/quickstart/spa/svelte" ] }, { "group": "Regular Web App", "pages": [ - "docs/quickstart/webapp/nextjs/index", - "docs/quickstart/webapp/nuxt/index", - "docs/quickstart/webapp/express/index", - "docs/quickstart/webapp/fastify/index", - "docs/quickstart/webapp/python/index", + "docs/quickstart/webapp/nextjs", + "docs/quickstart/webapp/nuxt", + "docs/quickstart/webapp/express", + "docs/quickstart/webapp/fastify", + "docs/quickstart/webapp/python", "docs/quickstart/webapp/django/interactive", - "docs/quickstart/webapp/fastapi/index", + "docs/quickstart/webapp/fastapi", "docs/quickstart/webapp/golang", - "docs/quickstart/webapp/java/index", - "docs/quickstart/webapp/java-ee/index", - "docs/quickstart/webapp/java-spring-boot/index", - "docs/quickstart/webapp/aspnet-core-blazor-server/index", - "docs/quickstart/webapp/aspnet-core/index", + "docs/quickstart/webapp/java", + "docs/quickstart/webapp/java-ee", + "docs/quickstart/webapp/java-spring-boot", + "docs/quickstart/webapp/aspnet-core-blazor-server", + "docs/quickstart/webapp/aspnet-core", "docs/quickstart/webapp/laravel/interactive", "docs/quickstart/webapp/php/interactive", "docs/quickstart/webapp/nginx-plus/interactive", "docs/quickstart/webapp/apache/interactive", "docs/quickstart/webapp/rails/interactive", - "docs/quickstart/webapp/hono/index" + "docs/quickstart/webapp/hono" ] }, { "group": "Native/Mobile App", "pages": [ - "docs/quickstart/native/ios-swift/index", - "docs/quickstart/native/android/index", - "docs/quickstart/native/android-facebook-login/index", - "docs/quickstart/native/ios-swift-facebook-login/index", - "docs/quickstart/native/react-native/index", - "docs/quickstart/native/react-native-expo/index", - "docs/quickstart/native/flutter/index", + "docs/quickstart/native/ios-swift", + "docs/quickstart/native/android", + "docs/quickstart/native/android-facebook-login", + "docs/quickstart/native/ios-swift-facebook-login", + "docs/quickstart/native/react-native", + "docs/quickstart/native/react-native-expo", + "docs/quickstart/native/flutter", "docs/quickstart/native/net-android-ios/index", - "docs/quickstart/native/maui/index", - "docs/quickstart/native/ionic-angular/index", - "docs/quickstart/native/ionic-react/index", - "docs/quickstart/native/ionic-vue/index", - "docs/quickstart/native/windows-uwp-csharp/interactive", + "docs/quickstart/native/maui", + "docs/quickstart/native/ionic-angular", + "docs/quickstart/native/ionic-react", + "docs/quickstart/native/ionic-vue", + "docs/quickstart/native/windows-uwp-csharp", "docs/quickstart/native/device/interactive", - "docs/quickstart/native/xamarin" + "docs/quickstart/native/xamarin/index" ] }, { "group": "Backend/API", "pages": [ - "docs/quickstart/backend/nodejs/index", + "docs/quickstart/backend/nodejs", "docs/quickstart/backend/fastify/index", "docs/quickstart/backend/django/interactive", "docs/quickstart/backend/python/index", - "docs/quickstart/backend/fastapi/index", + "docs/quickstart/backend/fastapi", "docs/quickstart/backend/java-spring-security5/index", - "docs/quickstart/backend/golang/index", - "docs/quickstart/backend/aspnet-core-webapi/index", - "docs/quickstart/backend/webapi-owin/interactive", + "docs/quickstart/backend/golang", + "docs/quickstart/backend/aspnet-core-webapi", + "docs/quickstart/backend/webapi-owin", "docs/quickstart/backend/laravel/interactive", "docs/quickstart/backend/php/interactive", "docs/quickstart/backend/rails/interactive" diff --git a/main/docs/fr-ca/quickstart/backend/golang/interactive.mdx b/main/docs/fr-ca/quickstart/backend/golang/interactive.mdx index e633833072..491cac23c4 100644 --- a/main/docs/fr-ca/quickstart/backend/golang/interactive.mdx +++ b/main/docs/fr-ca/quickstart/backend/golang/interactive.mdx @@ -7,7 +7,6 @@ sidebarTitle: Go API import { Recipe, Content, Section, SideMenu, SideMenuSectionItem, SignUpForm } from "/snippets/recipe.jsx"; import { LoggedInForm } from "/snippets/Login.jsx"; -import Main from "/snippets/quickstart/backend/golang/main.go.mdx"; import {QuickstartButtons} from "/snippets/QuickstartButtons.jsx"; @@ -305,18 +304,5 @@ export const sections = [ - - - -
- - - - - -
- - - diff --git a/main/docs/ja-jp/quickstart/backend/golang/interactive.mdx b/main/docs/ja-jp/quickstart/backend/golang/interactive.mdx index da4c4bebf4..b69bc79b2b 100644 --- a/main/docs/ja-jp/quickstart/backend/golang/interactive.mdx +++ b/main/docs/ja-jp/quickstart/backend/golang/interactive.mdx @@ -7,7 +7,6 @@ sidebarTitle: Go API import { Recipe, Content, Section, SideMenu, SideMenuSectionItem, SignUpForm } from "/snippets/recipe.jsx"; import { LoggedInForm } from "/snippets/Login.jsx"; -import Main from "/snippets/quickstart/backend/golang/main.go.mdx"; import {QuickstartButtons} from "/snippets/QuickstartButtons.jsx"; @@ -307,17 +306,5 @@ export const sections = [ - - -
- - - - - -
- - - diff --git a/main/docs/quickstart/backend/aspnet-core-webapi/index.mdx b/main/docs/quickstart/backend/aspnet-core-webapi.mdx similarity index 100% rename from main/docs/quickstart/backend/aspnet-core-webapi/index.mdx rename to main/docs/quickstart/backend/aspnet-core-webapi.mdx diff --git a/main/docs/quickstart/backend/fastapi/index.mdx b/main/docs/quickstart/backend/fastapi.mdx similarity index 100% rename from main/docs/quickstart/backend/fastapi/index.mdx rename to main/docs/quickstart/backend/fastapi.mdx diff --git a/main/docs/quickstart/backend/golang/index.mdx b/main/docs/quickstart/backend/golang.mdx similarity index 100% rename from main/docs/quickstart/backend/golang/index.mdx rename to main/docs/quickstart/backend/golang.mdx diff --git a/main/docs/quickstart/backend/nodejs/index.mdx b/main/docs/quickstart/backend/nodejs.mdx similarity index 100% rename from main/docs/quickstart/backend/nodejs/index.mdx rename to main/docs/quickstart/backend/nodejs.mdx diff --git a/main/docs/quickstart/native/android-facebook-login/index.mdx b/main/docs/quickstart/native/android-facebook-login.mdx similarity index 100% rename from main/docs/quickstart/native/android-facebook-login/index.mdx rename to main/docs/quickstart/native/android-facebook-login.mdx diff --git a/main/docs/quickstart/native/android/index.mdx b/main/docs/quickstart/native/android.mdx similarity index 100% rename from main/docs/quickstart/native/android/index.mdx rename to main/docs/quickstart/native/android.mdx diff --git a/main/docs/quickstart/native/flutter/index.mdx b/main/docs/quickstart/native/flutter.mdx similarity index 100% rename from main/docs/quickstart/native/flutter/index.mdx rename to main/docs/quickstart/native/flutter.mdx diff --git a/main/docs/quickstart/native/ionic-angular/index.mdx b/main/docs/quickstart/native/ionic-angular.mdx similarity index 100% rename from main/docs/quickstart/native/ionic-angular/index.mdx rename to main/docs/quickstart/native/ionic-angular.mdx diff --git a/main/docs/quickstart/native/ionic-react/index.mdx b/main/docs/quickstart/native/ionic-react.mdx similarity index 100% rename from main/docs/quickstart/native/ionic-react/index.mdx rename to main/docs/quickstart/native/ionic-react.mdx diff --git a/main/docs/quickstart/native/ionic-vue/index.mdx b/main/docs/quickstart/native/ionic-vue.mdx similarity index 100% rename from main/docs/quickstart/native/ionic-vue/index.mdx rename to main/docs/quickstart/native/ionic-vue.mdx diff --git a/main/docs/quickstart/native/ios-swift-facebook-login/index.mdx b/main/docs/quickstart/native/ios-swift-facebook-login.mdx similarity index 100% rename from main/docs/quickstart/native/ios-swift-facebook-login/index.mdx rename to main/docs/quickstart/native/ios-swift-facebook-login.mdx diff --git a/main/docs/quickstart/native/ios-swift/index.mdx b/main/docs/quickstart/native/ios-swift.mdx similarity index 100% rename from main/docs/quickstart/native/ios-swift/index.mdx rename to main/docs/quickstart/native/ios-swift.mdx diff --git a/main/docs/quickstart/native/maui/index.mdx b/main/docs/quickstart/native/maui.mdx similarity index 100% rename from main/docs/quickstart/native/maui/index.mdx rename to main/docs/quickstart/native/maui.mdx diff --git a/main/docs/quickstart/native/react-native-expo/index.mdx b/main/docs/quickstart/native/react-native-expo.mdx similarity index 100% rename from main/docs/quickstart/native/react-native-expo/index.mdx rename to main/docs/quickstart/native/react-native-expo.mdx diff --git a/main/docs/quickstart/native/react-native/index.mdx b/main/docs/quickstart/native/react-native.mdx similarity index 100% rename from main/docs/quickstart/native/react-native/index.mdx rename to main/docs/quickstart/native/react-native.mdx diff --git a/main/docs/quickstart/native/windows-uwp-csharp/index.mdx b/main/docs/quickstart/native/windows-uwp-csharp.mdx similarity index 100% rename from main/docs/quickstart/native/windows-uwp-csharp/index.mdx rename to main/docs/quickstart/native/windows-uwp-csharp.mdx diff --git a/main/docs/quickstart/native/wpf-winforms/index.mdx b/main/docs/quickstart/native/wpf-winforms.mdx similarity index 100% rename from main/docs/quickstart/native/wpf-winforms/index.mdx rename to main/docs/quickstart/native/wpf-winforms.mdx diff --git a/main/docs/quickstart/spa/angular/index.mdx b/main/docs/quickstart/spa/angular.mdx similarity index 100% rename from main/docs/quickstart/spa/angular/index.mdx rename to main/docs/quickstart/spa/angular.mdx diff --git a/main/docs/quickstart/spa/capn-web/index.mdx b/main/docs/quickstart/spa/capn-web.mdx similarity index 100% rename from main/docs/quickstart/spa/capn-web/index.mdx rename to main/docs/quickstart/spa/capn-web.mdx diff --git a/main/docs/quickstart/spa/flutter/index.mdx b/main/docs/quickstart/spa/flutter.mdx similarity index 100% rename from main/docs/quickstart/spa/flutter/index.mdx rename to main/docs/quickstart/spa/flutter.mdx diff --git a/main/docs/quickstart/spa/react/index.mdx b/main/docs/quickstart/spa/react.mdx similarity index 100% rename from main/docs/quickstart/spa/react/index.mdx rename to main/docs/quickstart/spa/react.mdx diff --git a/main/docs/quickstart/spa/svelte/index.mdx b/main/docs/quickstart/spa/svelte.mdx similarity index 100% rename from main/docs/quickstart/spa/svelte/index.mdx rename to main/docs/quickstart/spa/svelte.mdx diff --git a/main/docs/quickstart/spa/vanillajs/index.mdx b/main/docs/quickstart/spa/vanillajs.mdx similarity index 100% rename from main/docs/quickstart/spa/vanillajs/index.mdx rename to main/docs/quickstart/spa/vanillajs.mdx diff --git a/main/docs/quickstart/spa/vuejs/index.mdx b/main/docs/quickstart/spa/vuejs.mdx similarity index 100% rename from main/docs/quickstart/spa/vuejs/index.mdx rename to main/docs/quickstart/spa/vuejs.mdx diff --git a/main/docs/quickstart/webapp/aspnet-core-blazor-server/index.mdx b/main/docs/quickstart/webapp/aspnet-core-blazor-server.mdx similarity index 100% rename from main/docs/quickstart/webapp/aspnet-core-blazor-server/index.mdx rename to main/docs/quickstart/webapp/aspnet-core-blazor-server.mdx diff --git a/main/docs/quickstart/webapp/aspnet-core/index.mdx b/main/docs/quickstart/webapp/aspnet-core.mdx similarity index 100% rename from main/docs/quickstart/webapp/aspnet-core/index.mdx rename to main/docs/quickstart/webapp/aspnet-core.mdx diff --git a/main/docs/quickstart/webapp/aspnet-owin/index.mdx b/main/docs/quickstart/webapp/aspnet-owin.mdx similarity index 100% rename from main/docs/quickstart/webapp/aspnet-owin/index.mdx rename to main/docs/quickstart/webapp/aspnet-owin.mdx diff --git a/main/docs/quickstart/webapp/express/index.mdx b/main/docs/quickstart/webapp/express.mdx similarity index 100% rename from main/docs/quickstart/webapp/express/index.mdx rename to main/docs/quickstart/webapp/express.mdx diff --git a/main/docs/quickstart/webapp/fastapi/index.mdx b/main/docs/quickstart/webapp/fastapi.mdx similarity index 100% rename from main/docs/quickstart/webapp/fastapi/index.mdx rename to main/docs/quickstart/webapp/fastapi.mdx diff --git a/main/docs/quickstart/webapp/fastify/index.mdx b/main/docs/quickstart/webapp/fastify.mdx similarity index 100% rename from main/docs/quickstart/webapp/fastify/index.mdx rename to main/docs/quickstart/webapp/fastify.mdx diff --git a/main/docs/quickstart/webapp/hono/index.mdx b/main/docs/quickstart/webapp/hono.mdx similarity index 100% rename from main/docs/quickstart/webapp/hono/index.mdx rename to main/docs/quickstart/webapp/hono.mdx diff --git a/main/docs/quickstart/webapp/java-ee/index.mdx b/main/docs/quickstart/webapp/java-ee.mdx similarity index 100% rename from main/docs/quickstart/webapp/java-ee/index.mdx rename to main/docs/quickstart/webapp/java-ee.mdx diff --git a/main/docs/quickstart/webapp/java-spring-boot/index.mdx b/main/docs/quickstart/webapp/java-spring-boot.mdx similarity index 100% rename from main/docs/quickstart/webapp/java-spring-boot/index.mdx rename to main/docs/quickstart/webapp/java-spring-boot.mdx diff --git a/main/docs/quickstart/webapp/java/index.mdx b/main/docs/quickstart/webapp/java.mdx similarity index 100% rename from main/docs/quickstart/webapp/java/index.mdx rename to main/docs/quickstart/webapp/java.mdx diff --git a/main/docs/quickstart/webapp/nextjs/index.mdx b/main/docs/quickstart/webapp/nextjs.mdx similarity index 100% rename from main/docs/quickstart/webapp/nextjs/index.mdx rename to main/docs/quickstart/webapp/nextjs.mdx diff --git a/main/docs/quickstart/webapp/nuxt/index.mdx b/main/docs/quickstart/webapp/nuxt.mdx similarity index 100% rename from main/docs/quickstart/webapp/nuxt/index.mdx rename to main/docs/quickstart/webapp/nuxt.mdx diff --git a/main/docs/quickstart/webapp/python/index.mdx b/main/docs/quickstart/webapp/python.mdx similarity index 100% rename from main/docs/quickstart/webapp/python/index.mdx rename to main/docs/quickstart/webapp/python.mdx From 897036a4b9a6067644e1e14c13b3a5cf482c59b7 Mon Sep 17 00:00:00 2001 From: Hazel Virdo Date: Wed, 27 May 2026 13:53:32 -0400 Subject: [PATCH 2/2] remove xamarin quickstart --- main/config/redirects.json | 8 +- main/docs/quickstart/native/xamarin.mdx | 356 ------------------ .../docs/quickstart/native/xamarin/_index.mdx | 5 - main/docs/quickstart/native/xamarin/index.mdx | 355 ----------------- .../quickstart/native/xamarin/interactive.mdx | 12 - 5 files changed, 2 insertions(+), 734 deletions(-) delete mode 100644 main/docs/quickstart/native/xamarin.mdx delete mode 100644 main/docs/quickstart/native/xamarin/_index.mdx delete mode 100644 main/docs/quickstart/native/xamarin/index.mdx delete mode 100644 main/docs/quickstart/native/xamarin/interactive.mdx diff --git a/main/config/redirects.json b/main/config/redirects.json index 51b8b2617e..493edc1270 100644 --- a/main/config/redirects.json +++ b/main/config/redirects.json @@ -16408,16 +16408,12 @@ "destination": "/docs/quickstart/spa/react/02-calling-an-api" }, { - "source": "/docs/quickstart/native/xamarin/interactive", - "destination": "/docs/quickstart/native/net-android-ios/interactive" - }, - { - "source": "/docs/quickstart/native/xamarin", + "source": "/docs/quickstart/native/xamarin/*", "destination": "/docs/quickstart/native/net-android-ios/interactive" }, { "source": "/docs/xamarin-tutorial", - "destination": "/docs/quickstart/native/xamarin" + "destination": "/docs/quickstart/native/net-android-ios/interactive" }, { "source": "/docs/wpf-winforms-tutorial", diff --git a/main/docs/quickstart/native/xamarin.mdx b/main/docs/quickstart/native/xamarin.mdx deleted file mode 100644 index 81e3e8a89c..0000000000 --- a/main/docs/quickstart/native/xamarin.mdx +++ /dev/null @@ -1,356 +0,0 @@ ---- -title: "Add Login to Your .NET Android & iOS Application" -sidebarTitle: ".NET Android & iOS" ---- -import {AuthCodeBlock} from "/snippets/AuthCodeBlock.jsx"; - -# .NET Android and iOS - -![Gravatar for frederik.prijck@auth0.com](https://www.gravatar.com/avatar/b74fc62fbaf2a93d1db3c549f62d4d9a?d=mm&r=g&s=50) - -##### By Frederik Prijck - -This tutorial demonstrates how to add user login with Auth0 to a .NET Android or iOS application.We recommend that you log in to follow this quickstart with examples configured for your account. - -{/* - System requirements: Visual Studio 2022+ or Visual Studio for Mac | Xamarin for Visual Studio | .NET6+ - */} - -This quickstart focusses on .NET Android and iOS, as they are the next generation of `Xamarin.Android` and `Xamarin.iOS`. If you are still using `Xamarin.Android` and `Xamarin.iOS`, you can follow this guide as well as integration is identical and the SDKs are compatible. - -**New to Auth?** Learn [How Auth0 works](/docs/overview), how it [integrates with Native Applications](/docs/architecture-scenarios/application/mobile-api) and which [protocol](/docs/api-auth/grant/authorization-code-pkce) it uses. - -## Configure Auth0 - -### Get Your Application Keys - -When you signed up for Auth0, a new application was created for you, or you could have created a new one. You will need some details about that application to communicate with Auth0. You can get these details from the [Application Settings](https://manage.auth0.com/#/applications) section in the Auth0 dashboard. - -![App Dashboard](https://cdn2.auth0.com/docs/1.14550.0/media/articles/dashboard/client_settings.png) - -When using the Default App with a Native or Single Page Application, ensure to update the **Token Endpoint Authentication Method** to `None` and set the **Application Type** to either `SPA` or `Native`. - -You need the following information: - -* **Domain** -* **Client ID** - -If you download the sample from the top of this page, these details are filled out for you. - -### Configure Callback URLs - -A callback URL is a URL in your application where Auth0 redirects the user after they have authenticated. The callback URL for your app must be added to the **Allowed Callback URLs** field in your [Application Settings](https://manage.auth0.com/#/applications). If this field is not set, users will be unable to log in to the application and will get an error. - -Callback URLs are the URLs that Auth0 invokes after the authentication process. Auth0 routes your application back to this URL and appends additional parameters to it, including an access code which will be exchanged for an ID Token, Access Token, and Refresh Token. - -Since callback URLs can be manipulated, you will need to add your application's URL to your application's *Allowed Callback URLs* for security. This will enable Auth0 to recognize these URLs as valid. If omitted, authentication will not be successful. - -* For Android, the callback URL will be in the format - - ``` - YOUR_ANDROID_PACKAGE_NAME://{yourDomain}/android/YOUR_ANDROID_PACKAGE_NAME/callback - ``` - - - - - - - where `YOUR_ANDROID_PACKAGE_NAME` is the Package Name for your application, such as `com.mycompany.myapplication`. -* For iOS, the callback URL will be in the format - - ``` - YOUR_BUNDLE_IDENTIFIER://{yourDomain}/ios/YOUR_BUNDLE_IDENTIFIER/callback - ``` - - - - - - - where `YOUR_BUNDLE_IDENTIFIER` is the Bundle Identifier for your application, such as `com.mycompany.myapplication`. - -Ensure that the Callback URL is in lowercase. - -### Configure Logout URLs - -A logout URL is a URL in your application that Auth0 can return to after the user has been logged out of the authorization server. This is specified in the `returnTo` query parameter. The logout URL for your app must be added to the **Allowed Logout URLs** field in your [Application Settings](https://manage.auth0.com/#/applications). If this field is not set, users will be unable to log out from the application and will get an error. - -If you are following along with the sample project you downloaded from the top of this page, the logout URL you need to add to the Allowed Logout URLs field is the same as the callback URL. - -## Install Dependencies - -If you are using Visual Studio, simply open the Package Manager Console (View -> Other Windows -> Package Manager Console), and install the package: - -**For Android:** - -``` -Install-Package Auth0.OidcClient.AndroidX -``` - - - - - - -**For iOS:** - -``` -Install-Package Auth0.OidcClient.iOS -``` - - - - - - -Alternatively, if you are using Visual Studio for Mac, please perform the following steps: - -1. With the project loaded in Visual Studio for Mac, Ctrl+click (or right click) on the **Packages** folder of the project in the **Solution Pad**, and select **Add Packages...** -2. The **Add Packages** dialog will appear. Search and locate the package called `Auth0.OidcClient.AndroidX` or `Auth0.OidcClient.iOS` depending on your platform. -3. Tick the checkbox next to the package to select it, and click the **Add Package** button - -## Trigger Authentication - -To integrate Auth0 login into your application, instantiate an instance of the `Auth0Client` class, configuring the Auth0 Domain and Client ID: - -``` -using Auth0.OidcClient; - -var client = new Auth0Client(new Auth0ClientOptions -{ - Domain = "{yourDomain}", - ClientId = "{yourClientId}" -}, this); -``` - - - - - - -Then, call the `LoginAsync` method which will redirect the user to the login screen. You will typically do this in the event handler for a UI control such as a Login button. - -```javascript lines -var loginResult = await client.LoginAsync(); -``` - - - - - - -### Handing the callback URL - -After a user has logged in, they will be redirected back to your application at the **Callback URL** that was registered before. In both Android and iOS you need to handle this callback to complete the authentication flow. - -### Android - -Register an intent which will handle this callback URL. An easy way to do this is to register the intent on the same activity from which you called the `LoginAsync` method to initiate the authentication flow. - -export const codeExample = `[Activity(Label = "AndroidSample", MainLauncher = true, Icon = "@drawable/icon", - LaunchMode = LaunchMode.SingleTask)] -[IntentFilter( - new[] { Intent.ActionView }, - Categories = new[] { Intent.CategoryDefault, Intent.CategoryBrowsable }, - DataScheme = "YOUR_ANDROID_PACKAGE_NAME", - DataHost = "{yourDomain}", - DataPathPrefix = "/android/YOUR_ANDROID_PACKAGE_NAME/callback")] -public class MainActivity : Activity -{ - // Code omitted -}`; - - - - - - - - -Replace `YOUR_ANDROID_PACKAGE_NAME` in the code sample above with the actual Package Name for your application, such as `com.mycompany.myapplication`. Also ensure that all the text for the `DataScheme`, `DataHost`, and `DataPathPrefix` is in lower case. Also, set `LaunchMode = LaunchMode.SingleTask` for the `Activity`, otherwise the system will create a new instance of the activity every time the Callback URL gets called. - -Now write code to handle the intent. You can do this by overriding the `OnNewIntent` method. Inside the method you need to call the `Send` method on the `ActivityMediator` to complete the authentication cycle: - -``` -protected override async void OnNewIntent(Intent intent) -{ - base.OnNewIntent(intent); - - Auth0.OidcClient.ActivityMediator.Instance.Send(intent.DataString); -} -``` - - - - - - -### iOS - -Register the URL scheme for your Callback URL which your application should handle: - -1. Open your application's `Info.plist` file in Visual Studio for Mac, and go to the **Advanced** tab. -2. Under **URL Types**, click the **Add URL Type** button -3. Set the **Identifier** as `Auth0`, the **URL Schemes** the same as your application's **Bundle Identifier**, and the **Role** as `None` - -This is an example of the XML representation of your `info.plist` file after you have added the URL Type: - -``` -CFBundleURLTypes - - - CFBundleTypeRole - None - CFBundleURLName - Auth0 - CFBundleURLSchemes - - YOUR_BUNDLE_IDENTIFIER - - - -``` - - - - - - -You need to handle the Callback URL in the `OpenUrl` event in your `AppDelegate` class. You need to notify the Auth0 OIDC Client to finish the authentication flow by calling the `Send` method of the `ActivityMediator` singleton, pass along the URL that was sent in: - -``` -using Auth0.OidcClient; - -[Register("AppDelegate")] -public class AppDelegate : UIApplicationDelegate -{ - public override bool OpenUrl(UIApplication application, NSUrl url, string sourceApplication, NSObject annotation) - { - ActivityMediator.Instance.Send(url.AbsoluteString); - - return true; - } -} -``` - - - - - - -### Run the application - -With the above code in place, a user can log in to your application using Auth0. - -![Universal Login](https://cdn2.auth0.com/docs/1.14550.0/media/articles/native-platforms/android/login-android.png) - -## Accessing the User's Information - -The returned login result will indicate whether authentication was successful and if so contain the tokens and claims of the user. - -### Authentication Error - -You can check the `IsError` property of the result to see whether the login has failed. The `ErrorMessage` will contain more information regarding the error which occurred. - -```javascript lines -var loginResult = await client.LoginAsync(); - -if (loginResult.IsError) -{ - Debug.WriteLine($"An error occurred during login: {loginResult.Error}") -} -``` - - - - - - -### Accessing the tokens - -On successful login, the login result will contain the ID Token and Access Token in the `IdentityToken` and `AccessToken` properties respectively. - -```javascript lines -var loginResult = await client.LoginAsync(); - -if (!loginResult.IsError) -{ - Debug.WriteLine($"id_token: {loginResult.IdentityToken}"); - Debug.WriteLine($"access_token: {loginResult.AccessToken}"); -} -``` - - - - - - -### Obtaining the User Information - -On successful login, the login result will contain the user information in the `User` property, which is a [ClaimsPrincipal](https://msdn.microsoft.com/en-us/library/system.security.claims.claimsprincipal(v=vs.110).aspx). - -To obtain information about the user, you can query the claims. You can, for example, obtain the user's name and email address from the `name` and `email` claims: - -``` -if (!loginResult.IsError) -{ - Debug.WriteLine($"name: {loginResult.User.FindFirst(c => c.Type == "name")?.Value}"); - Debug.WriteLine($"email: {loginResult.User.FindFirst(c => c.Type == "email")?.Value}"); -} -``` - - - - - - -The exact claims returned will depend on the scopes that were requested. For more information see the [Using Scopes](https://auth0.github.io/auth0-oidc-client-net/documentation/advanced-scenarios/scopes.html) in the Auth0 OIDC Application documentation. - -You can obtain a list of all the claims contained in the ID Token by iterating through the `Claims` collection: - -``` -if (!loginResult.IsError) -{ - foreach (var claim in loginResult.User.Claims) - { - Debug.WriteLine($"{claim.Type} = {claim.Value}"); - } -} -``` - - - - - - -## Logout - -To log the user out call the `LogoutAsync` method. - -``` -BrowserResultType browserResult = await client.LogoutAsync(); -``` - - - - - - -##### What can you do next? - -[* Configure other identity providers](/docs/authenticate/identity-providers)[* Enable multifactor authentication](/docs/secure/multi-factor-authentication)[* Learn about attack protection](/docs/secure/attack-protection)[* Learn about rules](/docs/rules) - ---- - - - - - - - -[Edit on GitHub](https://github.com/auth0/docs/edit/master/articles/quickstart/native/net-android-ios/01-login.md) diff --git a/main/docs/quickstart/native/xamarin/_index.mdx b/main/docs/quickstart/native/xamarin/_index.mdx deleted file mode 100644 index 1ed6b0f100..0000000000 --- a/main/docs/quickstart/native/xamarin/_index.mdx +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: Xamarin - -url: docs/quickstart/native/net-android-ios/interactive ---- \ No newline at end of file diff --git a/main/docs/quickstart/native/xamarin/index.mdx b/main/docs/quickstart/native/xamarin/index.mdx deleted file mode 100644 index ecfe5b1c75..0000000000 --- a/main/docs/quickstart/native/xamarin/index.mdx +++ /dev/null @@ -1,355 +0,0 @@ ---- -title: "Add Login to Your .NET Android & iOS Application" -sidebarTitle: ".NET Android & iOS" ---- -import {AuthCodeBlock} from "/snippets/AuthCodeBlock.jsx"; - - -##### By Frederik Prijck - -This tutorial demonstrates how to add user login to a Xamarin application using Auth0.We recommend that you log in to follow this quickstart with examples configured for your account. - -{/* -System requirements: Visual Studio 2022 or Visual Studio for Mac | Xamarin for Visual Studio | .NET 6+ - */} - - -This quickstart focusses on .NET Android and iOS, as they are the next generation of `Xamarin.Android` and `Xamarin.iOS`. If you are still using `Xamarin.Android` and `Xamarin.iOS`, you can follow this guide as well as integration is identical and the SDKs are compatible. - - - - -**New to Auth?** Learn [How Auth0 works](/docs/get-started/auth0-overview), how it [integrates with Native Applications](/docs/get-started/architecture-scenarios/mobile-api) and which [protocol](/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce) it uses. - - -## Configure Auth0 - -### Get Your Application Keys - -When you signed up for Auth0, a new application was created for you, or you could have created a new one. You will need some details about that application to communicate with Auth0. You can get these details from the [Application Settings](https://manage.auth0.com/#/applications) section in the Auth0 dashboard. - -![App Dashboard](https://cdn2.auth0.com/docs/1.14550.0/media/articles/dashboard/client_settings.png) - - -When using the Default App with a Native or Single Page Application, ensure to update the **Token Endpoint Authentication Method** to `None` and set the **Application Type** to either `SPA` or `Native`. - - -You need the following information: - -* **Domain** -* **Client ID** - - -If you download the sample from the top of this page, these details are filled out for you. - - -### Configure Callback URLs - -A callback URL is a URL in your application where Auth0 redirects the user after they have authenticated. The callback URL for your app must be added to the **Allowed Callback URLs** field in your [Application Settings](https://manage.auth0.com/#/applications). If this field is not set, users will be unable to log in to the application and will get an error. - -Callback URLs are the URLs that Auth0 invokes after the authentication process. Auth0 routes your application back to this URL and appends additional parameters to it, including an access code which will be exchanged for an ID Token, Access Token, and Refresh Token. - -Since callback URLs can be manipulated, you will need to add your application's URL to your application's *Allowed Callback URLs* for security. This will enable Auth0 to recognize these URLs as valid. If omitted, authentication will not be successful. - -* For Android, the callback URL will be in the format - - ``` - YOUR_ANDROID_PACKAGE_NAME://{yourDomain}/android/YOUR_ANDROID_PACKAGE_NAME/callback - ``` - - - - - - - where `YOUR_ANDROID_PACKAGE_NAME` is the Package Name for your application, such as `com.mycompany.myapplication`. -* For iOS, the callback URL will be in the format - - ``` - YOUR_BUNDLE_IDENTIFIER://{yourDomain}/ios/YOUR_BUNDLE_IDENTIFIER/callback - ``` - - - - - - - where `YOUR_BUNDLE_IDENTIFIER` is the Bundle Identifier for your application, such as `com.mycompany.myapplication`. - -Ensure that the Callback URL is in lowercase. - -### Configure Logout URLs - -A logout URL is a URL in your application that Auth0 can return to after the user has been logged out of the authorization server. This is specified in the `returnTo` query parameter. The logout URL for your app must be added to the **Allowed Logout URLs** field in your [Application Settings](https://manage.auth0.com/#/applications). If this field is not set, users will be unable to log out from the application and will get an error. - - -If you are following along with the sample project you downloaded from the top of this page, the logout URL you need to add to the Allowed Logout URLs field is the same as the callback URL. - - -## Install Dependencies - -If you are using Visual Studio, simply open the Package Manager Console (View -> Other Windows -> Package Manager Console), and install the package: - -**For Android:** - -``` -Install-Package Auth0.OidcClient.AndroidX -``` - - - - - - -**For iOS:** - -``` -Install-Package Auth0.OidcClient.iOS -``` - - - - - - -Alternatively, if you are using Visual Studio for Mac, please perform the following steps: - -1. With the project loaded in Visual Studio for Mac, Ctrl+click (or right click) on the **Packages** folder of the project in the **Solution Pad**, and select **Add Packages...** -2. The **Add Packages** dialog will appear. Search and locate the package called `Auth0.OidcClient.AndroidX` or `Auth0.OidcClient.iOS` depending on your platform. -3. Tick the checkbox next to the package to select it, and click the **Add Package** button - -## Trigger Authentication - -To integrate Auth0 login into your application, instantiate an instance of the `Auth0Client` class, configuring the Auth0 Domain and Client ID: - -export const codeExample1 = `using Auth0.OidcClient; - -var client = new Auth0Client(new Auth0ClientOptions -{ - Domain = "{yourDomain}", - ClientId = "{yourClientId}" -}, this);`; - - - - - - - - -Then, call the `LoginAsync` method which will redirect the user to the login screen. You will typically do this in the event handler for a UI control such as a Login button. - -```cs lines -var loginResult = await client.LoginAsync(); -``` - - - - - - -### Handing the callback URL - -After a user has logged in, they will be redirected back to your application at the **Callback URL** that was registered before. In both Android and iOS you need to handle this callback to complete the authentication flow. - -### Android - -Register an intent which will handle this callback URL. An easy way to do this is to register the intent on the same activity from which you called the `LoginAsync` method to initiate the authentication flow. - -export const codeExample2 = `[Activity(Label = "AndroidSample", MainLauncher = true, Icon = "@drawable/icon", - LaunchMode = LaunchMode.SingleTask)] -[IntentFilter( - new[] { Intent.ActionView }, - Categories = new[] { Intent.CategoryDefault, Intent.CategoryBrowsable }, - DataScheme = "YOUR_ANDROID_PACKAGE_NAME", - DataHost = "{yourDomain}", - DataPathPrefix = "/android/YOUR_ANDROID_PACKAGE_NAME/callback")] -public class MainActivity : Activity -{ - // Code omitted -}`; - - - - - - - - -Replace `YOUR_ANDROID_PACKAGE_NAME` in the code sample above with the actual Package Name for your application, such as `com.mycompany.myapplication`. Also ensure that all the text for the `DataScheme`, `DataHost`, and `DataPathPrefix` is in lower case. Also, set `LaunchMode = LaunchMode.SingleTask` for the `Activity`, otherwise the system will create a new instance of the activity every time the Callback URL gets called. - -Now write code to handle the intent. You can do this by overriding the `OnNewIntent` method. Inside the method you need to call the `Send` method on the `ActivityMediator` to complete the authentication cycle: - -```cs lines -protected override async void OnNewIntent(Intent intent) -{ - base.OnNewIntent(intent); - - Auth0.OidcClient.ActivityMediator.Instance.Send(intent.DataString); -} -``` - - - - - - -### iOS - -Register the URL scheme for your Callback URL which your application should handle: - -1. Open your application's `Info.plist` file in Visual Studio for Mac, and go to the **Advanced** tab. -2. Under **URL Types**, click the **Add URL Type** button -3. Set the **Identifier** as `Auth0`, the **URL Schemes** the same as your application's **Bundle Identifier**, and the **Role** as `None` - -This is an example of the XML representation of your `info.plist` file after you have added the URL Type: - -```xml lines -CFBundleURLTypes - - - CFBundleTypeRole - None - CFBundleURLName - Auth0 - CFBundleURLSchemes - - YOUR_BUNDLE_IDENTIFIER - - - -``` - - - - - - -You need to handle the Callback URL in the `OpenUrl` event in your `AppDelegate` class. You need to notify the Auth0 OIDC Client to finish the authentication flow by calling the `Send` method of the `ActivityMediator` singleton, pass along the URL that was sent in: - -```cs lines -using Auth0.OidcClient; - -[Register("AppDelegate")] -public class AppDelegate : UIApplicationDelegate -{ - public override bool OpenUrl(UIApplication application, NSUrl url, string sourceApplication, NSObject annotation) - { - ActivityMediator.Instance.Send(url.AbsoluteString); - - return true; - } -} -``` - - - - - - -### Run the application - -With the above code in place, a user can log in to your application using Auth0. - -![Universal Login](https://cdn2.auth0.com/docs/1.14550.0/media/articles/native-platforms/android/login-android.png) - -## Accessing the User's Information - -The returned login result will indicate whether authentication was successful and if so contain the tokens and claims of the user. - -### Authentication Error - -You can check the `IsError` property of the result to see whether the login has failed. The `ErrorMessage` will contain more information regarding the error which occurred. - -```cs lines -var loginResult = await client.LoginAsync(); - -if (loginResult.IsError) -{ - Debug.WriteLine($"An error occurred during login: {loginResult.Error}") -} -``` - - - - - - -### Accessing the tokens - -On successful login, the login result will contain the ID Token and Access Token in the `IdentityToken` and `AccessToken` properties respectively. - -```cs lines -var loginResult = await client.LoginAsync(); - -if (!loginResult.IsError) -{ - Debug.WriteLine($"id_token: {loginResult.IdentityToken}"); - Debug.WriteLine($"access_token: {loginResult.AccessToken}"); -} -``` - - - - - - -### Obtaining the User Information - -On successful login, the login result will contain the user information in the `User` property, which is a [ClaimsPrincipal](https://msdn.microsoft.com/en-us/library/system.security.claims.claimsprincipal(v=vs.110).aspx). - -To obtain information about the user, you can query the claims. You can, for example, obtain the user's name and email address from the `name` and `email` claims: - -```cs lines -if (!loginResult.IsError) -{ - Debug.WriteLine($"name: {loginResult.User.FindFirst(c => c.Type == "name")?.Value}"); - Debug.WriteLine($"email: {loginResult.User.FindFirst(c => c.Type == "email")?.Value}"); -} -``` - - - - - - -The exact claims returned will depend on the scopes that were requested. For more information see the [Using Scopes](https://auth0.github.io/auth0-oidc-client-net/documentation/advanced-scenarios/scopes.html) in the Auth0 OIDC Application documentation. - - -You can obtain a list of all the claims contained in the ID Token by iterating through the `Claims` collection: - -```cs lines -if (!loginResult.IsError) -{ - foreach (var claim in loginResult.User.Claims) - { - Debug.WriteLine($"{claim.Type} = {claim.Value}"); - } -} -``` - - - - - - -## Logout - -To log the user out call the `LogoutAsync` method. - -```cs lines -BrowserResultType browserResult = await client.LogoutAsync(); -``` - - - - - - - -##### What can you do next? -| [Configure other identity providers](/docs/authenticate/identity-providers) | [Enable multifactor authentication](/docs/secure/multi-factor-authentication) | -| --- | --- | -| [Learn about attack protection](/docs/secure/attack-protection) | [Learn about rules](/docs/customize/rules) | -[Edit on GitHub](https://github.com/auth0/docs/edit/master/articles/quickstart/backend/aspnet-core-webapi/01-authorization.md) - \ No newline at end of file diff --git a/main/docs/quickstart/native/xamarin/interactive.mdx b/main/docs/quickstart/native/xamarin/interactive.mdx deleted file mode 100644 index 3d3fc62497..0000000000 --- a/main/docs/quickstart/native/xamarin/interactive.mdx +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: This tutorial demonstrates how to add user login with Auth0 to a - .NET Android or iOS application. - and iOS Application' - to a .NET Android or iOS application. - Android and iOS Application' ---- ---- -title: Xamarin - -url: docs/quickstart/native/net-android-ios/interactive ----