From e6b13f080bda268c5599c22a005ca93d218de13f Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Tue, 21 Apr 2026 22:53:08 +0600 Subject: [PATCH 01/16] initial onboarding flow for non-tech users --- .../get-started/guides/first-things-first.mdx | 65 ++++++++++++++++++- 1 file changed, 63 insertions(+), 2 deletions(-) diff --git a/src/content/docs/get-started/guides/first-things-first.mdx b/src/content/docs/get-started/guides/first-things-first.mdx index 16f30bdeb..e394175dc 100644 --- a/src/content/docs/get-started/guides/first-things-first.mdx +++ b/src/content/docs/get-started/guides/first-things-first.mdx @@ -1,8 +1,10 @@ --- page_id: 2e4e5fca-9e1d-4c7d-b1bf-6a7e35d51847 -title: Where to start with Kinde +title: First things first sidebar: order: 1 +tableOfContents: + maxHeadingLevel: 3 description: Essential guide for getting started with Kinde including business setup, quick start options, and onboarding process for new users. relatedArticles: - 5c7de06d-f065-4a8a-81cb-f6914ee374f7 @@ -28,12 +30,71 @@ keywords: - business setup - tech stack - social authentication -updated: 2024-01-15 +updated: 2026-04-21 featured: false deprecated: false ai_summary: Essential guide for getting started with Kinde including business setup, quick start options, and onboarding process for new users. --- +Kinde lets you add user management, authentication, billing, and everything you need to build your SaaS product. Follow the steps to get started with Kinde for free (no credit card required). + +## Onboarding (for non-technical users) + +### 1. Create your account + +1. Go to **https://app.kinde.com/register** +2. Select the **Start for free** button in the top-right corner +3. Enter your **First name**, **Last name**, and **Email address** +4. Select **Create your account** button + +### 2. Verify your email + +1. A **one-time code** will be sent to your email +2. Open your email, copy the code, and enter it on the verification screen +3. Submit the code to continue + +### 3. Add business details + +1. Enter your **Business name** +2. Choose a **Kinde domain name** (e.g., "your brand name", apple.kinde.com) + + + +3. Select a **Region** where your data will be stored (pick a region closest to your country or your customer base) +4. Select **Next** + +### 4. Create a project + +Projects are applications in Kinde. This is how you can allow your users and businesses to register to your product. + +You will see two options: +- **Start a project from scratch** +- **Use Kinde with my existing code base** + +1. Select **Start a project from scratch** option +2. Select **Next** +3. Select the **technology** you plan to use (e.g., React), or choose **Other** + + + +4. Select **Next** + +### 5. Choose sign-in method + +1. On the **How do users sign in?** screen, leave **Email** enabled (this is usually turned on by default). +2. Add any other sign-in methods you want your users to use (e.g., Google, Facebook) +3. Select **Next** + +### 6. Finish Setup + +1. When you reach the **Almost there…** screen, select **No thanks, I’ll explore at my own pace.** + +You will now be taken to the **Kinde Dashboard**, where you can begin using the platform. + First, [sign up for a business and get a Kinde domain](https://app.kinde.com/register). ## Choose your own business adventure From 19b339501f0b4199c35d6af4128f5d6a0ed369eb Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Tue, 21 Apr 2026 23:59:30 +0600 Subject: [PATCH 02/16] update the onboarding flow in first thing first page --- .../get-started/guides/first-things-first.mdx | 54 +++++++------------ 1 file changed, 20 insertions(+), 34 deletions(-) diff --git a/src/content/docs/get-started/guides/first-things-first.mdx b/src/content/docs/get-started/guides/first-things-first.mdx index e394175dc..00da910ee 100644 --- a/src/content/docs/get-started/guides/first-things-first.mdx +++ b/src/content/docs/get-started/guides/first-things-first.mdx @@ -14,6 +14,7 @@ app_context: - m: default - m: login - m: register + - m: onboarding topics: - get-started - guides @@ -38,7 +39,7 @@ ai_summary: Essential guide for getting started with Kinde including business se Kinde lets you add user management, authentication, billing, and everything you need to build your SaaS product. Follow the steps to get started with Kinde for free (no credit card required). -## Onboarding (for non-technical users) +## Onboarding for first-time users ### 1. Create your account @@ -95,46 +96,31 @@ You will see two options: You will now be taken to the **Kinde Dashboard**, where you can begin using the platform. -First, [sign up for a business and get a Kinde domain](https://app.kinde.com/register). +![Kinde Dashboard](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/0c867d36-ab83-4fff-34ba-0db528c4ac00/socialsharingimage) -## Choose your own business adventure +## Complete your business details -When you sign up for a new business, you’ll be guided through a few decisions about how you want to set up your business, including the tech stack you use, the social authentication methods you want, and whether you are bringing your own code, or are starting from scratch. +1. On your dashboard, select **your business name** in the bottom-left corner, a pop-up appears +2. Select **Business details** -Then you’ll be asked if you want to use the Quick Start method to get your app connected. + ![Business details popup](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/562db191-bb01-47e4-48b6-640c99ac6a00/socialsharingimage) -![quickstart example](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/52d876f0-afc1-4f56-0c05-992c7f7a2800/public) +3. Update the following details: -## Take the Quick Start path +### Basic information -Follow our **Quick Start** guide to get connected fast. +1. From the **Basic information** section, add your: + - Phone number + - Email + - Kinde perk code (if you have one) + - Industry + - Time zone -You can jump straight in there from the onboarding, or you might have breezed through these steps so you can look around. Either way, here’s how to find your way back. +### Terms of use and privacy -1. On the Kinde home page, select **View details** on your app tile. -2. Select **Quick start** in the menu. -3. Select the relevant tab: **Starter kit** or **Existing codebase.** +1. Enter the URLs for your: + - Terms of use URL + - Privacy policy URL - ![Tab selection options](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/31311feb-d809-4d04-ab91-6986f4b1b000/public) +Select **Save** after all your details are added. -4. Follow the steps to get connected! - -If you need to, you can also change the technology you selected. - - - -## Resources for getting to know us - -Check out the [website](https://kinde.com/product-demo/), the [docs](/), the [blog](https://kinde.com/blog/), [videos](https://www.youtube.com/@heykinde), and hit up the [Slack community](https://join.slack.com/t/thekindecommunity/shared_invite/zt-1vyq8qilj-jFH5V27jfFnHk~BuBSU0ZA) to talk to other Kinde users. - -If you need help setting up, there’s a **#support** channel in the Slack community or you can contact us at [support@kinde.com](mailto:support@kinde.com) - -## More starter docs - -- [Our SDKs](/developer-tools/about/our-sdks/) -- Alternative guide for [connecting to Kinde from a blank slate](/get-started/guides/start-with-starter-kit/) -- Alternative guide for [connecting your own codebase](/get-started/guides/byo-code/) From 5c96468602caa1111465f1bde9c1bf2a317b18da Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Wed, 22 Apr 2026 14:33:45 +0600 Subject: [PATCH 03/16] updates the intro page with frontmatter, grammar cleanup, topic, and keywords --- .../get-started/guides/first-things-first.mdx | 96 ++++++++++++------- 1 file changed, 61 insertions(+), 35 deletions(-) diff --git a/src/content/docs/get-started/guides/first-things-first.mdx b/src/content/docs/get-started/guides/first-things-first.mdx index 00da910ee..6d985573f 100644 --- a/src/content/docs/get-started/guides/first-things-first.mdx +++ b/src/content/docs/get-started/guides/first-things-first.mdx @@ -5,7 +5,7 @@ sidebar: order: 1 tableOfContents: maxHeadingLevel: 3 -description: Essential guide for getting started with Kinde including business setup, quick start options, and onboarding process for new users. +description: Essential guide for getting started with Kinde including onboarding process for first-time users, adding business details, and team members. relatedArticles: - 5c7de06d-f065-4a8a-81cb-f6914ee374f7 - 281f3dd1-8fe6-4b4e-ba73-ddedd351524a @@ -14,10 +14,11 @@ app_context: - m: default - m: login - m: register - - m: onboarding topics: - get-started - guides + - onboarding + - team-and-account sdk: [] languages: [] audience: @@ -25,28 +26,33 @@ audience: - business owners complexity: beginner keywords: - - getting started - - quick start - - onboarding - - business setup - - tech stack - - social authentication -updated: 2026-04-21 + - Kinde registration + - email verification + - Kinde domain + - data region + - first project + - sign-in methods + - social connections + - business details + - terms of use + - privacy policy + - team members + - Kinde roles +updated: 2026-04-22 featured: false deprecated: false -ai_summary: Essential guide for getting started with Kinde including business setup, quick start options, and onboarding process for new users. +ai_summary: "This page is the entry guide for new Kinde customers. It covers registering at the Kinde app, verifying email with a one-time code, and entering business details including organization name, the Kinde subdomain (which cannot be changed later), and data region selection. It walks through creating a first project, starting from scratch or indicating an existing codebase, selecting an initial technology stack you can revise later, and choosing user sign-in options such as email and social providers. Readers learn how to complete guided onboarding to open the Kinde dashboard. The article then explains updating company information via the business menu (basic fields like phone, email, industry, timezone), adding terms of use and privacy policy URLs for hosted authentication widgets, and saving changes. Finally, it describes adding teammates through Members, assigning roles like Engineer for developer access, paid-plan requirements for roles beyond Owner and Admin, and links to deeper docs on Kinde domains, role permissions, and member invitations." --- -Kinde lets you add user management, authentication, billing, and everything you need to build your SaaS product. Follow the steps to get started with Kinde for free (no credit card required). +Kinde is the all-in-one developer platform for authentication, access management, and billing. Use it to secure and monetize your SaaS from day one. ## Onboarding for first-time users ### 1. Create your account 1. Go to **https://app.kinde.com/register** -2. Select the **Start for free** button in the top-right corner -3. Enter your **First name**, **Last name**, and **Email address** -4. Select **Create your account** button +2. Enter your **First name**, **Last name**, and **Email address** +3. Select the **Create your account** button ### 2. Verify your email @@ -57,51 +63,51 @@ Kinde lets you add user management, authentication, billing, and everything you ### 3. Add business details 1. Enter your **Business name** -2. Choose a **Kinde domain name** (e.g., "your brand name", apple.kinde.com) +2. Choose a **Kinde domain name** (e.g., `yourbrand.kinde.com`) -3. Select a **Region** where your data will be stored (pick a region closest to your country or your customer base) +3. Select a **Region** where your data will be stored (choose a region close to your operations or your customers) 4. Select **Next** ### 4. Create a project -Projects are applications in Kinde. This is how you can allow your users and businesses to register to your product. +Projects are applications in Kinde. They are how you let users and organizations sign up for your product. You will see two options: - **Start a project from scratch** - **Use Kinde with my existing code base** -1. Select **Start a project from scratch** option +1. Select the **Start a project from scratch** option 2. Select **Next** 3. Select the **technology** you plan to use (e.g., React), or choose **Other** 4. Select **Next** ### 5. Choose sign-in method -1. On the **How do users sign in?** screen, leave **Email** enabled (this is usually turned on by default). -2. Add any other sign-in methods you want your users to use (e.g., Google, Facebook) +1. On the **How do users sign in?** screen, enable **Email** (default setting) +2. Enable any other sign-in methods you want your users to use (for example, Google or Facebook). You can add more social and enterprise connections later from the dashboard. 3. Select **Next** -### 6. Finish Setup +### 6. Finish setup 1. When you reach the **Almost there…** screen, select **No thanks, I’ll explore at my own pace.** -You will now be taken to the **Kinde Dashboard**, where you can begin using the platform. + You will now be taken to the **Kinde Dashboard**, where you can begin using the platform. -![Kinde Dashboard](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/0c867d36-ab83-4fff-34ba-0db528c4ac00/socialsharingimage) + ![Kinde Dashboard](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/0c867d36-ab83-4fff-34ba-0db528c4ac00/socialsharingimage) ## Complete your business details -1. On your dashboard, select **your business name** in the bottom-left corner, a pop-up appears -2. Select **Business details** +1. On the dashboard, select **your business name** in the bottom-left corner. A pop-up appears. +2. In the pop-up, select **Business details**. ![Business details popup](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/562db191-bb01-47e4-48b6-640c99ac6a00/socialsharingimage) @@ -109,18 +115,38 @@ You will now be taken to the **Kinde Dashboard**, where you can begin using the ### Basic information -1. From the **Basic information** section, add your: - - Phone number - - Email - - Kinde perk code (if you have one) - - Industry - - Time zone +1. In the **Basic information** section, add your: + - **Phone number** (your business phone number) + - **Email** (your business email address) + - **Kinde perk code** (if you have one) + - **Industry** + - **Time zone** ### Terms of use and privacy -1. Enter the URLs for your: +1. Enter the publicly available URLs for your: - Terms of use URL - Privacy policy URL -Select **Save** after all your details are added. + After you add your **Terms of use** and **Privacy policy** URLs, users will see these links on the **Sign up** page in the widget footer. + + ![Terms of use and privacy](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/eace6e01-6501-4375-3fb9-29a14c50a900/socialsharingimage) + +When you finish, select **Save**. + +## Add team members + +1. Open the Kinde dashboard, select **your business name** in the bottom-left corner, then select **Team members** +2. On the **Members** page, select **Add member** +3. In the pop-up that opens, enter the team member's **First name**, **Last name**, and **Email** +4. Select the roles they will have in the business. For example, you can grant developer access with the **Engineer** role. For a full list of roles and their capabilities, see [Team member roles](/get-started/team-and-account/team-member-roles/). + + + +5. Select **Save**. + + Your team member will receive an email with an invitation to join your business on Kinde. They can set up an account or sign in to an existing account. + For more on team member management, see [Add team members](/get-started/team-and-account/add-team-members/). From 559fa189ed1a29e783db4b99632ca0cff269e2d2 Mon Sep 17 00:00:00 2001 From: Tamal Chowdhury Date: Fri, 24 Apr 2026 15:23:51 +0600 Subject: [PATCH 04/16] add test environment section in new doc page --- package-lock.json | 20 ----------- .../docs/get-started/guides/byo-code.mdx | 36 +++++++++++++++---- 2 files changed, 30 insertions(+), 26 deletions(-) diff --git a/package-lock.json b/package-lock.json index de0d487eb..8a937906a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -559,7 +559,6 @@ "version": "1.3.1", "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.3.1.tgz", "integrity": "sha512-kEBmG8KyqtxJZv+ygbEim+KCGtIq1fC22Ms3S4ziXmYKm8uyoLX0MHONVKwp+9opg390VaKRNt4a7A9NwmpNhw==", - "dev": true, "optional": true, "dependencies": { "tslib": "^2.4.0" @@ -1070,7 +1069,6 @@ "cpu": [ "arm64" ], - "dev": true, "optional": true, "os": [ "darwin" @@ -1092,7 +1090,6 @@ "cpu": [ "x64" ], - "dev": true, "optional": true, "os": [ "darwin" @@ -1114,7 +1111,6 @@ "cpu": [ "arm64" ], - "dev": true, "optional": true, "os": [ "darwin" @@ -1130,7 +1126,6 @@ "cpu": [ "x64" ], - "dev": true, "optional": true, "os": [ "darwin" @@ -1146,7 +1141,6 @@ "cpu": [ "arm" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1162,7 +1156,6 @@ "cpu": [ "arm64" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1178,7 +1171,6 @@ "cpu": [ "s390x" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1194,7 +1186,6 @@ "cpu": [ "x64" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1210,7 +1201,6 @@ "cpu": [ "arm64" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1226,7 +1216,6 @@ "cpu": [ "x64" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1242,7 +1231,6 @@ "cpu": [ "arm" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1264,7 +1252,6 @@ "cpu": [ "arm64" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1286,7 +1273,6 @@ "cpu": [ "s390x" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1308,7 +1294,6 @@ "cpu": [ "x64" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1330,7 +1315,6 @@ "cpu": [ "arm64" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1352,7 +1336,6 @@ "cpu": [ "x64" ], - "dev": true, "optional": true, "os": [ "linux" @@ -1374,7 +1357,6 @@ "cpu": [ "wasm32" ], - "dev": true, "optional": true, "dependencies": { "@emnapi/runtime": "^1.2.0" @@ -1393,7 +1375,6 @@ "cpu": [ "ia32" ], - "dev": true, "optional": true, "os": [ "win32" @@ -1412,7 +1393,6 @@ "cpu": [ "x64" ], - "dev": true, "optional": true, "os": [ "win32" diff --git a/src/content/docs/get-started/guides/byo-code.mdx b/src/content/docs/get-started/guides/byo-code.mdx index 413688298..8b39eda1d 100644 --- a/src/content/docs/get-started/guides/byo-code.mdx +++ b/src/content/docs/get-started/guides/byo-code.mdx @@ -1,8 +1,8 @@ --- page_id: 5c7de06d-f065-4a8a-81cb-f6914ee374f7 -title: Connect existing code base to Kinde +title: Add Kinde auth to your codebase sidebar: - order: 3 + order: 2 description: Guide for connecting existing codebases to Kinde including SDK selection, app configuration, callback URLs, and environment setup. relatedArticles: - 08415f77-cd58-498d-b3b2-d1cdda162153 @@ -34,12 +34,36 @@ deprecated: false ai_summary: Guide for connecting existing codebases to Kinde including SDK selection, app configuration, callback URLs, and environment setup. --- -Once you’ve got a [Kinde business and domain](https://app.kinde.com/register), you’re ready to get started. +Once you have [completed the onboarding process](/get-started/guides/first-things-first/), you are ready to add Kinde auth to your codebase. -You’ve got a couple of options: +### What you need + +- A [Kinde](https://kinde.com) account with **admin** or **engineer** access +- Familiarity with your preferred programming language and framework + +## Set up a test environment (Optional) + +Kinde comes with a default production environment, and the ability to create additional non-production environments. This is useful for testing in different environments without having to sign up for a new account. + +To create a test environment, do the following: + +1. Go to your Kinde dashboard, and select the arrow next to the production environment dropdown (top-left of the screen). A pop-up appears. +2. Select **All environments** +3. On the **Environments** page, select **Add environment** +4. Enter a **Name** (e.g., "Test") and a url friendly **Code** for the environment (e.g., "test"), then select **Save**. A new environment is created. +5. Select the **Switch to this environment** button to switch to the new environment. + + Every new environment comes with two default applications: + + - **Back-end web** - for connecting a server-side application + - **Front end and mobile** - for connecting a client-side application + + Your Kinde domain for this environment will be in the format of `https://-..kinde.com`. + + -- **Fast and easy** - Access the guided **Quick start** via the application tile on the Kinde home page, and follow the in-app instructions for using your own codebase. -- **DIY** - Follow the instructions below. ## 1: Get your SDK From 5e4f7e007d67b02e731e51d939d456ef6cdf6def Mon Sep 17 00:00:00 2001 From: Tamal Chowdhury Date: Fri, 24 Apr 2026 20:43:23 +0600 Subject: [PATCH 05/16] update the application setup steps --- .../docs/get-started/guides/byo-code.mdx | 115 +++++++++++------- 1 file changed, 73 insertions(+), 42 deletions(-) diff --git a/src/content/docs/get-started/guides/byo-code.mdx b/src/content/docs/get-started/guides/byo-code.mdx index 8b39eda1d..e09f2f92b 100644 --- a/src/content/docs/get-started/guides/byo-code.mdx +++ b/src/content/docs/get-started/guides/byo-code.mdx @@ -1,8 +1,10 @@ --- page_id: 5c7de06d-f065-4a8a-81cb-f6914ee374f7 -title: Add Kinde auth to your codebase +title: Add Kinde auth to your app sidebar: order: 2 +tableOfContents: + maxHeadingLevel: 3 description: Guide for connecting existing codebases to Kinde including SDK selection, app configuration, callback URLs, and environment setup. relatedArticles: - 08415f77-cd58-498d-b3b2-d1cdda162153 @@ -41,54 +43,45 @@ Once you have [completed the onboarding process](/get-started/guides/first-thing - A [Kinde](https://kinde.com) account with **admin** or **engineer** access - Familiarity with your preferred programming language and framework -## Set up a test environment (Optional) +## Quickstart -Kinde comes with a default production environment, and the ability to create additional non-production environments. This is useful for testing in different environments without having to sign up for a new account. +### 1. Set up a test environment (optional) -To create a test environment, do the following: +Kinde allows you to create non-production environments. If you want to setup a test environment, [see the guide below](#set-up-a-test-environment). -1. Go to your Kinde dashboard, and select the arrow next to the production environment dropdown (top-left of the screen). A pop-up appears. -2. Select **All environments** -3. On the **Environments** page, select **Add environment** -4. Enter a **Name** (e.g., "Test") and a url friendly **Code** for the environment (e.g., "test"), then select **Save**. A new environment is created. -5. Select the **Switch to this environment** button to switch to the new environment. +### 2. Create an application in Kinde - Every new environment comes with two default applications: +During the onboarding process, you created an application in Kinde. You can use this application to connect your codebase. You will find this application in your Kinde dashboard. - - **Back-end web** - for connecting a server-side application - - **Front end and mobile** - for connecting a client-side application - - Your Kinde domain for this environment will be in the format of `https://-..kinde.com`. +If you want to start over, follow the steps: - +1. Go to your Kinde dashboard, and select **Add application** +2. Enter a name for the application (e.g., "My App") and select the type of application, and select **Save**. + If you are unsure about which application type to select, head over to our [SDK page](/developer-tools/about/our-sdks/) and find the language or framework you are using. For backend/fullstack apps, select **Back-end web**. For client-side apps like web and mobile, select **Front end and mobile**. + +3. Select the application language/framework (e.g., React) and select **Save**. -## 1: Get your SDK +### 3. Add Kinde auth to your app -Browse [our SDK documentation](/developer-tools/about/our-sdks/) for the one you want. +You have two options: -SDK documentation contains language-specific instructions for connecting to Kinde. The steps in this document provide an overview of what you need to do. +- **Starter kit**: If you’re starting a brand new project or you just want to have a play around, using one of our starter kits gives you a ready-to-use project with Kinde already integrated with your tech of choice. Grab a starter kit from [GitHub](https://github.com/kinde-starter-kits). +- **Existing codebase**: If you already have a project, you can install the SDK manually. Follow the instructions for your selected SDK. -If we don’t have the language or framework you’re looking for, and you’re an experienced developer, try [using Kinde without an SDK](/developer-tools/about/using-kinde-without-an-sdk/). You can also [request an SDK](https://kinde-21631392.hs-sites.com/en-au/feature-request). +### 4. Set callback and redirect URLs -## 2: Add your application in Kinde +On the **Quick start** page, set the callback and redirect URLs for your app. -Next, you’ll want to connect your code base to the application you set up in Kinde. +For development, the URLs will be something like `http://localhost:3000/` and for production, this will be your live production URL (e.g., `https://myapp.com`). -Follow these steps to [add a new application to Kinde](/build/applications/add-and-manage-applications/). Kinde also comes with a couple of pre-built applications and you can use those ones if they suit. -Sign in to Kinde and go to **Settings > Applications**. - - ![kinde add application](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/494d739b-f60d-4f47-36f2-9e9f27f8c800/public) - -## 3: Get app keys +These define where a user goes when they sign in to you app. You need to set these in order to enable users to sign up. -View details of your application in Kinde and scroll down to [copy the App keys](/get-started/connect/getting-app-keys/). You’ll need to add these to your project’s `.env` file. +Enter default localhost details, such as below. Note that `http://localhost:3000` is an example of a commonly used local development URL. It should be replaced with the URL where your app is running. -## 4: Add callback URLs to your Kinde application +You can add other URLs later, when your production environment is ready to go live or you set up a custom domain. -While you are viewing the application details, set the callback and redirect URLs for your app. +### 5. Get app keys -These define where a user goes when they sign in to you app. You need to set these in order to enable users to sign up. +1. Go to **Details** page of your application to find your app keys. +2. Copy the following: -Enter default localhost details, such as below. Note that `http://localhost:3000` is an example of a commonly used local development URL. It should be replaced with the URL where your app is running. + - **Domain** (`yourbrand.kinde.com` or your custom domain) + - **Client ID** + - **Client secret** (for back-end and M2M apps) -You can add other URLs later, when your production environment is ready to go live or you set up a custom domain. - -## 5: Add app keys to the .env file +### 6. Add app keys to the .env file -Your code base will include an .env file (or something similar) for storing configuration information. Add the Kinde app details you copied at step 3 to your .env file +Your code base will include an .env file (or something similar) for storing configuration information. Add the Kinde app details you copied from the **Details** page to your .env file. Here’s an example from the Next.js app router SDK. You replace ``, ``, and `` with the Kinde app details. @@ -133,7 +127,7 @@ KINDE_POST_LOGOUT_REDIRECT_URL=http://localhost:3000 KINDE_POST_LOGIN_REDIRECT_URL=http://localhost:3000/dashboard ``` -## 6: Test user registration +### 7. Test user registration After you complete the previous steps, you should be able to register your first user. @@ -141,6 +135,43 @@ Register your first user by signing up yourself. To view the user, go to the mai Continue through the SDK to complete other configuration tasks. Then follow the link in step 7 below for a list of other set up tasks. -## 7: Set up Kinde to work how you want it +## Set up Kinde to work how you want it Start configuring Kinde to work the way you want by exploring [common set up tasks](/get-started/guides/set-up-tasks/) and customizations. That’s when you’ll really start to build your business on Kinde. + +## Set up a test environment + +Kinde comes with a default production environment, and the ability to create additional non-production environments. This is useful for testing in different environments without having to sign up for a new account. + +To create a test environment, do the following: + +1. Go to your Kinde dashboard, and select the arrow next to the production environment dropdown (top-left of the screen). A pop-up appears. +2. Select **All environments** +3. On the **Environments** page, select **Add environment** +4. Enter a **Name** (e.g., "Test") and a url friendly **Code** for the environment (e.g., "test"), then select **Save**. A new environment is created. +5. Select the **Switch to this environment** button to switch to the new environment. + + Every new environment comes with two default applications: + + - **Back-end web** - for connecting a server-side application + - **Front end and mobile** - for connecting a client-side application + + Your Kinde domain for this environment will be in the format of `https://-..kinde.com`. + + + +## End to end testing your Kinde apps + +To be added. + +## Copy application configuration across environments + +To be added. + +## Import users from another system + +To be added. + +## Next steps \ No newline at end of file From 9b120eb10bb079057c2f8a5733c4c46d799445d8 Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Sat, 25 Apr 2026 00:58:30 +0600 Subject: [PATCH 06/16] update the steps with screenshots --- .../docs/get-started/guides/byo-code.mdx | 67 ++++++++++--------- 1 file changed, 36 insertions(+), 31 deletions(-) diff --git a/src/content/docs/get-started/guides/byo-code.mdx b/src/content/docs/get-started/guides/byo-code.mdx index e09f2f92b..72c90860b 100644 --- a/src/content/docs/get-started/guides/byo-code.mdx +++ b/src/content/docs/get-started/guides/byo-code.mdx @@ -30,7 +30,7 @@ keywords: - environment variables - user registration - setup tasks -updated: 2025-11-11 +updated: 2026-04-25 featured: false deprecated: false ai_summary: Guide for connecting existing codebases to Kinde including SDK selection, app configuration, callback URLs, and environment setup. @@ -51,7 +51,7 @@ Kinde allows you to create non-production environments. If you want to setup a t ### 2. Create an application in Kinde -During the onboarding process, you created an application in Kinde. You can use this application to connect your codebase. You will find this application in your Kinde dashboard. +During the onboarding process, you created an application in Kinde. You can use this application by going to your Kinde dashboard and selecting **View details** on that application tile. Skip to step 3. If you want to start over, follow the steps: @@ -64,33 +64,32 @@ If you want to start over, follow the steps: ### 3. Add Kinde auth to your app -You have two options: +In the **Quick start** page of your application, you have two options: -- **Starter kit**: If you’re starting a brand new project or you just want to have a play around, using one of our starter kits gives you a ready-to-use project with Kinde already integrated with your tech of choice. Grab a starter kit from [GitHub](https://github.com/kinde-starter-kits). +- **Starter kit**: If you are starting a brand new project or you just want to have a play around, using one of our starter kits gives you a ready-to-use project with Kinde already integrated with your tech of choice. Grab a starter kit from [GitHub](https://github.com/kinde-starter-kits). - **Existing codebase**: If you already have a project, you can install the SDK manually. Follow the instructions for your selected SDK. ### 4. Set callback and redirect URLs On the **Quick start** page, set the callback and redirect URLs for your app. -For development, the URLs will be something like `http://localhost:3000/` and for production, this will be your live production URL (e.g., `https://myapp.com`). +![set the callback urls button](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/bbe9c5ec-051e-40e7-0d81-b9cce7adff00/socialsharingimage) +For development, the URLs will be something like `http://localhost:3000/` and for production, this will be your live production URL (e.g., `https://myapp.com`). These define where a user goes when they sign in to you app. You need to set these in order to enable users to sign up. -Enter default localhost details, such as below. Note that `http://localhost:3000` is an example of a commonly used local development URL. It should be replaced with the URL where your app is running. +Enter default localhost details, such as below. + + - +You can update or remove them from the **Details** page of your application. -You can add other URLs later, when your production environment is ready to go live or you set up a custom domain. +![callback and redirect urls in kinde](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/7b365904-880a-434b-889d-266961c3e700/socialsharingimage) + +You can add more URLs later, when your production environment is ready to go live or you set up a custom domain. ### 5. Get app keys @@ -101,44 +100,48 @@ You can add other URLs later, when your production environment is ready to go li - **Client ID** - **Client secret** (for back-end and M2M apps) - +![app keys in kinde](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/14be768e-4223-4218-716b-dc70ef732400/socialsharingimage) ### 6. Add app keys to the .env file Your code base will include an .env file (or something similar) for storing configuration information. Add the Kinde app details you copied from the **Details** page to your .env file. -Here’s an example from the Next.js app router SDK. You replace ``, ``, and `` with the Kinde app details. +Here’s an example from the Next.js app router SDK: -```bash +```env +# .env KINDE_CLIENT_ID= KINDE_CLIENT_SECRET= KINDE_ISSUER_URL=https://.kinde.com - KINDE_SITE_URL=http://localhost:3000 KINDE_POST_LOGOUT_REDIRECT_URL=http://localhost:3000 KINDE_POST_LOGIN_REDIRECT_URL=http://localhost:3000/dashboard ``` + + ### 7. Test user registration -After you complete the previous steps, you should be able to register your first user. +Run your app locally and click on the **Sign up** button. It will redirect you to the Kinde login page. -Register your first user by signing up yourself. To view the user, go to the main **Users** page in Kinde. +![kinde hosted login page](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/e13f9836-cb8a-4f06-5556-69d668a5a200/socialsharingimage) -Continue through the SDK to complete other configuration tasks. Then follow the link in step 7 below for a list of other set up tasks. +Complete the sign up process and it will redirect back to your app's dashboard page. If you run into an issue, take a look at the [common error codes page](/get-started/guides/error-codes/). + +Go to your **Kinde dashboard > Users** to find the user profile you just created. + +![kinde dashboard users page](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/9f3ace08-61d1-4392-89b8-6e8ea3f85100/socialsharingimage) ## Set up Kinde to work how you want it Start configuring Kinde to work the way you want by exploring [common set up tasks](/get-started/guides/set-up-tasks/) and customizations. That’s when you’ll really start to build your business on Kinde. +## Add social and enterprise connections + +To be added. + ## Set up a test environment Kinde comes with a default production environment, and the ability to create additional non-production environments. This is useful for testing in different environments without having to sign up for a new account. @@ -174,4 +177,6 @@ To be added. To be added. +## Deploy to production + ## Next steps \ No newline at end of file From 0dc161d500cc0fb14b55ddacd88d08106b125a78 Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Sun, 26 Apr 2026 22:57:55 +0600 Subject: [PATCH 07/16] add new advance sections for the page --- .../docs/get-started/guides/byo-code.mdx | 113 ++++++++++++++---- 1 file changed, 93 insertions(+), 20 deletions(-) diff --git a/src/content/docs/get-started/guides/byo-code.mdx b/src/content/docs/get-started/guides/byo-code.mdx index 72c90860b..856265a23 100644 --- a/src/content/docs/get-started/guides/byo-code.mdx +++ b/src/content/docs/get-started/guides/byo-code.mdx @@ -30,7 +30,7 @@ keywords: - environment variables - user registration - setup tasks -updated: 2026-04-25 +updated: 2026-04-26 featured: false deprecated: false ai_summary: Guide for connecting existing codebases to Kinde including SDK selection, app configuration, callback URLs, and environment setup. @@ -106,7 +106,7 @@ You can add more URLs later, when your production environment is ready to go liv Your code base will include an .env file (or something similar) for storing configuration information. Add the Kinde app details you copied from the **Details** page to your .env file. -Here’s an example from the Next.js app router SDK: +Here’s an example from the [Next.js app router SDK](/developer-tools/sdks/backend/nextjs-sdk/): ```env # .env @@ -124,25 +124,87 @@ Make sure you do not commit your client secret to source control, by adding your ### 7. Test user registration -Run your app locally and click on the **Sign up** button. It will redirect you to the Kinde login page. +1. Run your app locally and click on the **Sign up** button. It will redirect you to the Kinde login page. -![kinde hosted login page](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/e13f9836-cb8a-4f06-5556-69d668a5a200/socialsharingimage) + ![kinde hosted login page](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/e13f9836-cb8a-4f06-5556-69d668a5a200/socialsharingimage) -Complete the sign up process and it will redirect back to your app's dashboard page. If you run into an issue, take a look at the [common error codes page](/get-started/guides/error-codes/). +2. Complete the sign up process and it will redirect back to your app's dashboard page. If you run into an issue, take a look at the [common error codes page](/get-started/guides/error-codes/). -Go to your **Kinde dashboard > Users** to find the user profile you just created. +3. Go to your **Kinde dashboard > Users** to find the user profile you just created. -![kinde dashboard users page](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/9f3ace08-61d1-4392-89b8-6e8ea3f85100/socialsharingimage) + ![kinde dashboard users page](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/9f3ace08-61d1-4392-89b8-6e8ea3f85100/socialsharingimage) -## Set up Kinde to work how you want it + Here, you can edit this user's profile details and even perform admin actions like suspending or deleting the user. Read more about [user management](/manage-users/about/) in Kinde. -Start configuring Kinde to work the way you want by exploring [common set up tasks](/get-started/guides/set-up-tasks/) and customizations. That’s when you’ll really start to build your business on Kinde. + + +## Advanced configuration + +### Change Kinde design and branding + +You can change the Kinde hosted login page to match your brand. + +1. Go to Kinde dashboard > **Design** to change your brand colors, logo, favicon, button colors, and content copy. +2. To remove the Kinde branding, go to Kinde dashboard > select **Your business name > Business details > Global display settings** > disable the **Show Kinde branding** switch. + + + +Take a look at the [guide for changing Kinde design and branding](/design/brand/global-brand-defaults/) for more details. + +### Import users to Kinde + +You can add users from the Kinde dashboard or import your existing users from other platforms or your database. To add single users: + +1. Go to Kinde dashboard > **Users** > **Add user**. +2. Enter the user's email address and select **Save**. +3. The user will receive an email to set their password. + +You can migrate users from other platforms such as Auth0, Clerk, Firebase, or your own custom platform. Take a look at the [dedicated migration guides here](/get-started/switch-to-kinde/switch-to-kinde-for-user-authentication/). + +### Change authentication strategies -## Add social and enterprise connections +The default authentication strategy is to use email and OTP code for user sign up and sign in. You can add different auth strategies for your app such as: -To be added. +- Email + code (default) +- Phone or WhatsApp auth +- Username + code +- Email + password +- Username + password -## Set up a test environment +Here is a general guide to configure the authentication strategies: + +1. Go to your application > **View details** > **Authentication**. +2. Enable the authentication strategy you want to use. +3. Select **Save**. + +If you are using phone or WhatsApp connections, you may need to configure it in Kinde. Take a look at the [authentication methods](/authenticate/authentication-methods/set-up-user-authentication/) page for more details and setup instructions for each. + + + +### Setup social or enterprise connections + +You can allow your users to sign in with social profiles such as Google, Facebook, GitHub, etc. You can also use enterprise connections such as Microsoft Entra ID or SAML. To configure social or enterprise connections, these are the general steps: + +1. Go to **Settings > Environment > Authentication**. +2. In the **Social connections** or **Enterprise connections** section, select **Add connection**. +3. In the window that appears, select the service you want to use and select **Next**. +4. Configure the connection details and select **Save**. +5. Go to your application > **View details** > **Authentication** and enable the connection you just added. + +Take a look at the detailed sections for each of the auth methods and how to configure them. + +- [Add social sign in with Kinde](/authenticate/social-sign-in/add-social-sign-in/) +- [Add enterprise connections with Kinde](/authenticate/enterprise-connections/about-enterprise-connections/) + +## Advanced developer topics + +### Set up a test environment Kinde comes with a default production environment, and the ability to create additional non-production environments. This is useful for testing in different environments without having to sign up for a new account. @@ -165,18 +227,29 @@ To create a test environment, do the following: Kinde free plan allows you to create only one non-production environment. If you want to create more (e.g., dev, staging), you will need a paid plan. See [Kinde pricing](https://kinde.com/pricing/) for more details. -## End to end testing your Kinde apps +### Use Kinde Management API to perform admin actions + +The Kinde Management API lets you automate admin tasks such as managing users, roles, permissions, and applications. To get started: + +1. Go to your Kinde dashboard and select **Add application**. Give it a name, select **Machine to machine** as the type, then select **Save**. +2. Go to **APIs** page, select the three dots next to the **Kinde Management API** and choose **Authorize application**. +3. Select the three dots again and choose **Manage scopes**. Enable only the scopes you need, then select **Save**. +4. Select **View details** on the Kinde Management API, then select **Test**. Choose your M2M application and select **Get token** to generate a test token. + +See the full [Kinde Management API reference](/kinde-apis/management/) for available endpoints and usage examples. + +### Copy application configuration across environments -To be added. +Because Kinde environments are isolated and changes don't auto-promote, you need to manage your configuration as code. You can use a seeding script with the Kinde Management API to replicate application settings, such as connections, roles, and permissions consistently across dev, staging, and production. [See the guide for managing Kinde configuration via API](/developer-tools/guides/manage-kinde-configuration/). -## Copy application configuration across environments +### End to end testing your Kinde apps -To be added. +Kinde supports automated testing for authentication flows, protected features, and backend API endpoints. You can use browser automation tools like Playwright or Cypress to test sign-up, sign-in, and sign-out flows, or use refresh tokens to test protected API routes without a browser. -## Import users from another system +[See the end-to-end testing overview](/testing/) for setup instructions and implementation guides for each approach. -To be added. +### Deploy to production -## Deploy to production +- [Prepare your production environment to go live](/build/environments/production-to-live/). +- Deploy your app to: [Vercel](/developer-tools/guides/deploy-on-vercel/), [Netlify](/developer-tools/guides/deploy-on-netlify/) or [Cloudflare Workers](/developer-tools/guides/deploy-on-cloudflare-workers/). -## Next steps \ No newline at end of file From 00bdfb418ecff34f20da15fabd6969521784be35 Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Sun, 26 Apr 2026 23:12:29 +0600 Subject: [PATCH 08/16] add image and new sub section --- src/content/docs/get-started/guides/byo-code.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/src/content/docs/get-started/guides/byo-code.mdx b/src/content/docs/get-started/guides/byo-code.mdx index 856265a23..848f3753b 100644 --- a/src/content/docs/get-started/guides/byo-code.mdx +++ b/src/content/docs/get-started/guides/byo-code.mdx @@ -175,6 +175,8 @@ The default authentication strategy is to use email and OTP code for user sign u - Email + password - Username + password +![kinde auth strategies](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/7b866fcb-0b23-4ebf-bb66-5176d66b6900/socialsharingimage) + Here is a general guide to configure the authentication strategies: 1. Go to your application > **View details** > **Authentication**. @@ -202,6 +204,10 @@ Take a look at the detailed sections for each of the auth methods and how to con - [Add social sign in with Kinde](/authenticate/social-sign-in/add-social-sign-in/) - [Add enterprise connections with Kinde](/authenticate/enterprise-connections/about-enterprise-connections/) +### Add a custom domain and email sender + +To be added. + ## Advanced developer topics ### Set up a test environment @@ -227,7 +233,7 @@ To create a test environment, do the following: Kinde free plan allows you to create only one non-production environment. If you want to create more (e.g., dev, staging), you will need a paid plan. See [Kinde pricing](https://kinde.com/pricing/) for more details. -### Use Kinde Management API to perform admin actions +### Use Kinde Management API to automate admin tasks The Kinde Management API lets you automate admin tasks such as managing users, roles, permissions, and applications. To get started: From 4f169e36acdc1358e5ce64889ee18ca8e163bfad Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Mon, 27 Apr 2026 14:37:34 +0600 Subject: [PATCH 09/16] update the doc with metadata and ai_summary --- .../docs/get-started/guides/byo-code.mdx | 104 +++++++++++------- .../get-started/guides/first-things-first.mdx | 4 + 2 files changed, 68 insertions(+), 40 deletions(-) diff --git a/src/content/docs/get-started/guides/byo-code.mdx b/src/content/docs/get-started/guides/byo-code.mdx index 848f3753b..3c94b4472 100644 --- a/src/content/docs/get-started/guides/byo-code.mdx +++ b/src/content/docs/get-started/guides/byo-code.mdx @@ -1,21 +1,25 @@ --- page_id: 5c7de06d-f065-4a8a-81cb-f6914ee374f7 -title: Add Kinde auth to your app +title: Add Kinde auth to your codebase sidebar: order: 2 + label: Add Kinde to your codebase tableOfContents: maxHeadingLevel: 3 -description: Guide for connecting existing codebases to Kinde including SDK selection, app configuration, callback URLs, and environment setup. +description: Guide for adding Kinde authentication to an existing codebase, how to customize your setup, and how to build and deploy your app. relatedArticles: - 08415f77-cd58-498d-b3b2-d1cdda162153 - 684fc526-a338-4a67-9af6-742a39b66aff app_context: - - m: default - - m: login - - m: register + - m: settings + - s: applications topics: - get-started - guides + - authentication + - configuration + - environments + - deployment sdk: [] languages: - bash @@ -24,16 +28,27 @@ audience: complexity: intermediate keywords: - existing codebase - - sdk documentation + - SDK installation + - starter kit - app keys - - callback urls + - callback URLs + - redirect URLs - environment variables + - .env file - user registration - - setup tasks -updated: 2026-04-26 + - user migration + - authentication strategies + - social sign-in + - enterprise connections + - custom domain + - branding + - management API + - test environment + - deploy to production +updated: 2026-04-27 featured: false deprecated: false -ai_summary: Guide for connecting existing codebases to Kinde including SDK selection, app configuration, callback URLs, and environment setup. +ai_summary: "This guide walks developers through adding Kinde authentication to an existing codebase after completing onboarding. The quickstart covers six steps: creating or reusing a Kinde application, choosing between a starter kit or manual SDK installation, setting callback and redirect URLs, retrieving app keys (domain, client ID, client secret), adding those keys to a .env file, and testing user registration. Beyond the quickstart, the guide covers customizing your setup — updating Kinde's hosted login page to match your brand, importing or migrating users from platforms like Auth0, Clerk, or Firebase, switching authentication strategies (email + code, email + password, phone, or social and enterprise connections), and configuring a custom domain and email sender. The build and deploy section covers creating non-production test environments, using the Kinde Management API to automate admin tasks, replicating configuration across environments with a seeding script, running end-to-end tests with tools like Playwright or Cypress, and deploying to Vercel, Netlify, or Cloudflare Workers." --- Once you have [completed the onboarding process](/get-started/guides/first-things-first/), you are ready to add Kinde auth to your codebase. @@ -45,31 +60,27 @@ Once you have [completed the onboarding process](/get-started/guides/first-thing ## Quickstart -### 1. Set up a test environment (optional) +### 1. Create a new application in Kinde -Kinde allows you to create non-production environments. If you want to setup a test environment, [see the guide below](#set-up-a-test-environment). - -### 2. Create an application in Kinde - -During the onboarding process, you created an application in Kinde. You can use this application by going to your Kinde dashboard and selecting **View details** on that application tile. Skip to step 3. +During the onboarding process, you created an application in Kinde. You can use this application by going to your Kinde dashboard and selecting **View details** on that application tile. Skip to the next step (use a starter kit or install manually). If you want to start over, follow the steps: -1. Go to your Kinde dashboard, and select **Add application** -2. Enter a name for the application (e.g., "My App") and select the type of application, and select **Save**. +1. Go to your Kinde dashboard and select **Add application**. +2. Enter a name for the application (e.g., "My App"), select the type of application, and select **Save**. If you are unsure about which application type to select, head over to our [SDK page](/developer-tools/about/our-sdks/) and find the language or framework you are using. For backend/fullstack apps, select **Back-end web**. For client-side apps like web and mobile, select **Front end and mobile**. 3. Select the application language/framework (e.g., React) and select **Save**. -### 3. Add Kinde auth to your app +### 2. Use a starter kit or install manually -In the **Quick start** page of your application, you have two options: +On the **Quick start** page of your application, you have two options: - **Starter kit**: If you are starting a brand new project or you just want to have a play around, using one of our starter kits gives you a ready-to-use project with Kinde already integrated with your tech of choice. Grab a starter kit from [GitHub](https://github.com/kinde-starter-kits). - **Existing codebase**: If you already have a project, you can install the SDK manually. Follow the instructions for your selected SDK. -### 4. Set callback and redirect URLs +### 3. Set callback and redirect URLs On the **Quick start** page, set the callback and redirect URLs for your app. @@ -77,9 +88,9 @@ On the **Quick start** page, set the callback and redirect URLs for your app. For development, the URLs will be something like `http://localhost:3000/` and for production, this will be your live production URL (e.g., `https://myapp.com`). -These define where a user goes when they sign in to you app. You need to set these in order to enable users to sign up. +These define where a user goes when they sign in to your app. You need to set these to enable users to sign up. -Enter default localhost details, such as below. +Enter your local development URL to get started. -### 7. Test user registration +### 6. Test user registration -1. Run your app locally and click on the **Sign up** button. It will redirect you to the Kinde login page. +1. Run your app locally and select the **Sign up** button. You'll be redirected to the Kinde login page. ![kinde hosted login page](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/e13f9836-cb8a-4f06-5556-69d668a5a200/socialsharingimage) -2. Complete the sign up process and it will redirect back to your app's dashboard page. If you run into an issue, take a look at the [common error codes page](/get-started/guides/error-codes/). +2. Complete the sign up process and you'll be redirected back to your app's dashboard page. If you run into an issue, take a look at the [common error codes page](/get-started/guides/error-codes/). 3. Go to your **Kinde dashboard > Users** to find the user profile you just created. @@ -140,7 +151,7 @@ Make sure you do not commit your client secret to source control, by adding your Users created in different applications all add to the same environment in your Kinde business. -## Advanced configuration +## Customize your setup ### Change Kinde design and branding @@ -167,7 +178,7 @@ You can migrate users from other platforms such as Auth0, Clerk, Firebase, or yo ### Change authentication strategies -The default authentication strategy is to use email and OTP code for user sign up and sign in. You can add different auth strategies for your app such as: +By default, Kinde uses **Email + code** authentication strategy for user sign up and sign in. You can add different auth strategies for your app such as: - Email + code (default) - Phone or WhatsApp auth @@ -183,13 +194,13 @@ Here is a general guide to configure the authentication strategies: 2. Enable the authentication strategy you want to use. 3. Select **Save**. -If you are using phone or WhatsApp connections, you may need to configure it in Kinde. Take a look at the [authentication methods](/authenticate/authentication-methods/set-up-user-authentication/) page for more details and setup instructions for each. +If you want to use phone or WhatsApp connections, you will need to configure these services with Kinde. Take a look at the [authentication methods](/authenticate/authentication-methods/set-up-user-authentication/) page for more details and setup instructions for each. -### Setup social or enterprise connections +### Set up social or enterprise connections You can allow your users to sign in with social profiles such as Google, Facebook, GitHub, etc. You can also use enterprise connections such as Microsoft Entra ID or SAML. To configure social or enterprise connections, these are the general steps: @@ -206,9 +217,19 @@ Take a look at the detailed sections for each of the auth methods and how to con ### Add a custom domain and email sender -To be added. +Use your own domain to create a seamless user experience. To set up a custom domain, follow the steps below: + +1. Go to your Kinde dashboard and select **Settings > Environment > Custom domain**. +2. Select **Add custom domain**. +3. In the dialog, enter your custom domain such as `auth.yourcompany.com`. +4. Select **Save**. + +For a detailed setup instruction, see the [guide for using your own custom domain](/build/domains/pointing-your-domain/). + +You can customize the email sender, email copy, design, and even use your own SMTP providers for a fully branded messaging experience. See the [guide for customizing email sender](/get-started/connect/customize-email-sender/) for more details. + -## Advanced developer topics +## Build and deploy ### Set up a test environment @@ -219,7 +240,7 @@ To create a test environment, do the following: 1. Go to your Kinde dashboard, and select the arrow next to the production environment dropdown (top-left of the screen). A pop-up appears. 2. Select **All environments** 3. On the **Environments** page, select **Add environment** -4. Enter a **Name** (e.g., "Test") and a url friendly **Code** for the environment (e.g., "test"), then select **Save**. A new environment is created. +4. Enter a **Name** (e.g., "Test") and a URL-friendly **Code** for the environment (e.g., "test"), then select **Save**. A new environment is created. 5. Select the **Switch to this environment** button to switch to the new environment. Every new environment comes with two default applications: @@ -237,10 +258,13 @@ To create a test environment, do the following: The Kinde Management API lets you automate admin tasks such as managing users, roles, permissions, and applications. To get started: -1. Go to your Kinde dashboard and select **Add application**. Give it a name, select **Machine to machine** as the type, then select **Save**. -2. Go to **APIs** page, select the three dots next to the **Kinde Management API** and choose **Authorize application**. -3. Select the three dots again and choose **Manage scopes**. Enable only the scopes you need, then select **Save**. -4. Select **View details** on the Kinde Management API, then select **Test**. Choose your M2M application and select **Get token** to generate a test token. +1. Go to your Kinde dashboard and select **Add application**. +2. Give it a name and select **Machine to machine** as the type, then select **Save**. +3. Go to the **APIs** page, select the three dots next to the **Kinde Management API** and choose **Authorize application**. +4. Select the three dots again and choose **Manage scopes**. Enable only the scopes you need, then select **Save**. +5. Go to the **Quick start** page of the app, select **Kinde Management API** from the dropdown, and select **Get token**. +6. Use the token to call the Kinde Management API. +7. You can also use a test token from this page. See the full [Kinde Management API reference](/kinde-apis/management/) for available endpoints and usage examples. diff --git a/src/content/docs/get-started/guides/first-things-first.mdx b/src/content/docs/get-started/guides/first-things-first.mdx index 6d985573f..7e5b360cf 100644 --- a/src/content/docs/get-started/guides/first-things-first.mdx +++ b/src/content/docs/get-started/guides/first-things-first.mdx @@ -150,3 +150,7 @@ When you finish, select **Save**. Your team member will receive an email with an invitation to join your business on Kinde. They can set up an account or sign in to an existing account. For more on team member management, see [Add team members](/get-started/team-and-account/add-team-members/). + +## Next steps + +- [Add Kinde to your codebase](/get-started/guides/byo-code/) \ No newline at end of file From 400a5f56eaf9dc0c5b77aa42fa3ce6e7c3b81e17 Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Mon, 27 Apr 2026 16:47:48 +0600 Subject: [PATCH 10/16] update the setup tasks page with roles and permissions --- .../docs/get-started/guides/byo-code.mdx | 88 ++------- .../get-started/guides/first-things-first.mdx | 10 +- .../docs/get-started/guides/set-up-tasks.mdx | 170 ++++++++++++++---- 3 files changed, 160 insertions(+), 108 deletions(-) diff --git a/src/content/docs/get-started/guides/byo-code.mdx b/src/content/docs/get-started/guides/byo-code.mdx index 3c94b4472..7cea878e6 100644 --- a/src/content/docs/get-started/guides/byo-code.mdx +++ b/src/content/docs/get-started/guides/byo-code.mdx @@ -151,83 +151,6 @@ Make sure you do not commit your client secret to source control, by adding your Users created in different applications all add to the same environment in your Kinde business. -## Customize your setup - -### Change Kinde design and branding - -You can change the Kinde hosted login page to match your brand. - -1. Go to Kinde dashboard > **Design** to change your brand colors, logo, favicon, button colors, and content copy. -2. To remove the Kinde branding, go to Kinde dashboard > select **Your business name > Business details > Global display settings** > disable the **Show Kinde branding** switch. - - - -Take a look at the [guide for changing Kinde design and branding](/design/brand/global-brand-defaults/) for more details. - -### Import users to Kinde - -You can add users from the Kinde dashboard or import your existing users from other platforms or your database. To add single users: - -1. Go to Kinde dashboard > **Users** > **Add user**. -2. Enter the user's email address and select **Save**. -3. The user will receive an email to set their password. - -You can migrate users from other platforms such as Auth0, Clerk, Firebase, or your own custom platform. Take a look at the [dedicated migration guides here](/get-started/switch-to-kinde/switch-to-kinde-for-user-authentication/). - -### Change authentication strategies - -By default, Kinde uses **Email + code** authentication strategy for user sign up and sign in. You can add different auth strategies for your app such as: - -- Email + code (default) -- Phone or WhatsApp auth -- Username + code -- Email + password -- Username + password - -![kinde auth strategies](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/7b866fcb-0b23-4ebf-bb66-5176d66b6900/socialsharingimage) - -Here is a general guide to configure the authentication strategies: - -1. Go to your application > **View details** > **Authentication**. -2. Enable the authentication strategy you want to use. -3. Select **Save**. - -If you want to use phone or WhatsApp connections, you will need to configure these services with Kinde. Take a look at the [authentication methods](/authenticate/authentication-methods/set-up-user-authentication/) page for more details and setup instructions for each. - - - -### Set up social or enterprise connections - -You can allow your users to sign in with social profiles such as Google, Facebook, GitHub, etc. You can also use enterprise connections such as Microsoft Entra ID or SAML. To configure social or enterprise connections, these are the general steps: - -1. Go to **Settings > Environment > Authentication**. -2. In the **Social connections** or **Enterprise connections** section, select **Add connection**. -3. In the window that appears, select the service you want to use and select **Next**. -4. Configure the connection details and select **Save**. -5. Go to your application > **View details** > **Authentication** and enable the connection you just added. - -Take a look at the detailed sections for each of the auth methods and how to configure them. - -- [Add social sign in with Kinde](/authenticate/social-sign-in/add-social-sign-in/) -- [Add enterprise connections with Kinde](/authenticate/enterprise-connections/about-enterprise-connections/) - -### Add a custom domain and email sender - -Use your own domain to create a seamless user experience. To set up a custom domain, follow the steps below: - -1. Go to your Kinde dashboard and select **Settings > Environment > Custom domain**. -2. Select **Add custom domain**. -3. In the dialog, enter your custom domain such as `auth.yourcompany.com`. -4. Select **Save**. - -For a detailed setup instruction, see the [guide for using your own custom domain](/build/domains/pointing-your-domain/). - -You can customize the email sender, email copy, design, and even use your own SMTP providers for a fully branded messaging experience. See the [guide for customizing email sender](/get-started/connect/customize-email-sender/) for more details. - ## Build and deploy @@ -283,3 +206,14 @@ Kinde supports automated testing for authentication flows, protected features, a - [Prepare your production environment to go live](/build/environments/production-to-live/). - Deploy your app to: [Vercel](/developer-tools/guides/deploy-on-vercel/), [Netlify](/developer-tools/guides/deploy-on-netlify/) or [Cloudflare Workers](/developer-tools/guides/deploy-on-cloudflare-workers/). +## Next steps + +Make Kinde your own by: + +- Change login page branding +- Import or migrate users +- Change auth strategies +- Add social or enterprise connections +- Add custom domain & email sender + +Check out the [Customize your setup](/get-started/guides/set-up-tasks/). \ No newline at end of file diff --git a/src/content/docs/get-started/guides/first-things-first.mdx b/src/content/docs/get-started/guides/first-things-first.mdx index 7e5b360cf..1ec16a4c1 100644 --- a/src/content/docs/get-started/guides/first-things-first.mdx +++ b/src/content/docs/get-started/guides/first-things-first.mdx @@ -153,4 +153,12 @@ When you finish, select **Save**. ## Next steps -- [Add Kinde to your codebase](/get-started/guides/byo-code/) \ No newline at end of file +Add Kinde auth to your codebase and learn about these developer topics: + +- Test user registration +- Set up test environments +- Use the Kinde Management API to automate admin tasks +- Run end-to-end tests +- Deploy your app to production + +Check out the [Add Kinde to your codebase](/get-started/guides/byo-code/). \ No newline at end of file diff --git a/src/content/docs/get-started/guides/set-up-tasks.mdx b/src/content/docs/get-started/guides/set-up-tasks.mdx index f80773ac8..686131a9b 100644 --- a/src/content/docs/get-started/guides/set-up-tasks.mdx +++ b/src/content/docs/get-started/guides/set-up-tasks.mdx @@ -1,8 +1,10 @@ --- page_id: 9b9ce8a8-dffb-47e5-82a9-e612b1947963 -title: Common set up tasks +title: Customize your setup sidebar: - order: 4 + order: 2 +tableOfContents: + maxHeadingLevel: 3 relatedArticles: - 720fcdda-daa6-4dff-ad2d-177af555e6bb - 2e4e5fca-9e1d-4c7d-b1bf-6a7e35d51847 @@ -37,48 +39,156 @@ The whole idea of Kinde is you can set it up the way you want, without too much Here are some common set up tasks. Depending on your business structure and how you want to do things, you may do some or all. -## Business settings +### What you need -- [Use your own domain](/build/domains/pointing-your-domain/) for sign up and sign in -- Add links to [privacy policy and terms of service](/manage-your-account/business-information/policies-terms/) -- [Invite team members](/get-started/team-and-account/add-team-members/) to help you set up -- [Create another environment](/build/environments/environments/), such as a local development environment +- A [Kinde](https://kinde.com) account with **Admin** access (sign up for free) +- Familiarity with auth strategies and user management -## Applications +## Change the log in experience -- Set [callback and redirect URLs](/get-started/connect/callback-urls/) in your applications, and ensure they match the URLs in your code. -- Switch on [authentication options](/authenticate/manage-authentication/user-auth-applications/) for your applications. +### Change authentication strategies -## Appearance and user experience +By default, Kinde uses **Email + code** authentication strategy for user sign up and sign in. You can add different auth strategies for your app such as: + +- Email + code (default) +- Phone or WhatsApp auth +- Username + code +- Email + password +- Username + password + +![kinde auth strategies](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/7b866fcb-0b23-4ebf-bb66-5176d66b6900/socialsharingimage) + +Here is a general guide to configure the authentication strategies: + +1. Go to your application > **View details** > **Authentication**. +2. Enable the authentication strategy you want to use. +3. Select **Save**. + +If you want to use phone or WhatsApp connections, you will need to configure these services with Kinde. Take a look at the [authentication methods](/authenticate/authentication-methods/set-up-user-authentication/) page for more details and setup instructions for each. + + + +### Set up social or enterprise connections + +You can allow your users to sign in with social profiles such as Google, Facebook, GitHub, etc. You can also use enterprise connections such as Microsoft Entra ID or SAML. To configure social or enterprise connections, these are the general steps: + +1. Go to **Settings > Environment > Authentication**. +2. In the **Social connections** or **Enterprise connections** section, select **Add connection**. +3. In the window that appears, select the service you want to use and select **Next**. +4. Configure the connection details and select **Save**. +5. Go to your application > **View details** > **Authentication** and enable the connection you just added. + +Take a look at the detailed sections for each of the auth methods and how to configure them. + +- [Add social sign in with Kinde](/authenticate/social-sign-in/add-social-sign-in/) +- [Add enterprise connections with Kinde](/authenticate/enterprise-connections/about-enterprise-connections/) + +### Change authentication page design + +You can change the Kinde hosted auth pages to match your brand: + +1. Go to Kinde dashboard > **Design** to change your: + + - Brand assets like Logo, Favicon, Avatar, and link colors + - Sign in and sign up page content + - Email content and copy + - Add custom code + +Take a look at the [guide for changing Kinde design and branding](/design/brand/global-brand-defaults/) for more details. + +### Remove the Kinde branding + +You can remove the default "Powered by Kinde" logo from the login page: + +1. Go to Kinde dashboard > select **Your business name > Business details**. +2. On the **Global display settings** > disable the **Show Kinde branding** switch. + + + +### Add a custom domain + +Use your own domain to create a seamless user experience. To set up a custom domain, follow the steps below: + +1. Go to your Kinde dashboard and select **Settings > Environment > Custom domain**. +2. Select **Add custom domain**. +3. In the dialog, enter your custom domain such as `auth.yourcompany.com`. +4. Select **Save**. + +For a detailed setup instruction, see the [guide for using your own custom domain](/build/domains/pointing-your-domain/). + +### Customize email sender + +You can customize the email sender, email copy, design, and even use your own SMTP providers for a fully branded messaging experience. + +1. Go to Kinde dashboard > select **Settings > Environment > Messaging > Email Sender**. +2. Enter a **Sender name** to change the email sender details. +3. Enable **Use custom sender** to add your own SMTP details. +4. To change the email contents, go to your Kinde dashboard > **Design** > **Email content** and update the email copy. + +See the [guide for customizing email sender](/get-started/connect/customize-email-sender/) for more details. + +## User management + +### Import users to Kinde + +You can add users from the Kinde dashboard or import your existing users from other platforms or your database. To add single users: + +1. Go to Kinde dashboard > **Users** > **Add user**. +2. Enter the user's email address and select **Save**. +3. The user will receive an email to set their password. + +You can migrate users from other platforms such as Auth0, Clerk, Firebase, or your own custom platform. Take a look at the [dedicated migration guides here](/get-started/switch-to-kinde/switch-to-kinde-for-user-authentication/). + +### Build your list - Set up the [request access](/design/pages/set-up-the-request-access-page/) page (if your app is not yet in the market) -- Add your [email provider details](/get-started/connect/customize-email-sender/) so emails come from you and not Kinde -- Set your global brand theme for [emails and pages](/design/brand/global-brand-defaults/), including sign up and sign in pages - [Create a form](/design/pages/subscription-form/) to collect emails from mailing list subscribers -## Authentication +### Add user permissions and roles + +Use role-based access control to grant users access to different features and resources in your app. + +To add user permissions: + +1. Go to Kinde dashboard > **Settings > User Management > Permissions**. +2. Select **Add permission** and enter the permission name, description, and key. +3. Select **Save**. + +To add user roles: + +1. Go to Kinde dashboard > **Settings > User Management > Roles**. +2. Select **Add role** and enter the role name, description, and key. +3. Select the permissions that are included in the role by switching them on. +4. Select **Save**. + +Add a role to a user: + +1. Go to Kinde dashboard > **Users** > select the user you want to update. +2. Select **Roles** and enable the role you want to add to the user. +3. Select **Save**. + +Learn more in the dedicated guides: + +- [Add user permissions](/manage-users/roles-and-permissions/user-permissions/) +- [Add and assign user roles](/manage-users/roles-and-permissions/user-roles/) -- Select and [set up authentication](/authenticate/authentication-methods/set-up-user-authentication/) for your apps (Email + passwordless is set up by default in your first app when you add a new business) -- Enable [social sign up options](/authenticate/social-sign-in/add-social-sign-in/) -- Set up [multi-factor authentication](/authenticate/multi-factor-auth/enable-multi-factor-authentication/) -- Add [MS Entra ID](/authenticate/enterprise-connections/azure/) or [SAML](/authenticate/enterprise-connections/custom-saml/) enterprise authentication (if you have enterprise customers) -- Manage the [authentication experience](/authenticate/custom-configurations/authentication-experience/), including error handling, sign up fields, marketing consent, etc. +## Add analytics and tracking -## Users +Kinde lets you add third-party analytics and tracking to your sign in and sign up pages. -- [Import users](/manage-users/add-and-edit/import-users-in-bulk/) into Kinde, or [add them manually](/manage-users/add-and-edit/add-and-edit-users/) -- Add [user permissions](/manage-users/roles-and-permissions/user-permissions/) -- Add and assign [user roles](/manage-users/roles-and-permissions/user-roles/) +- Add [Google Analytics](/manage-users/view-activity/track-user-sign-in-with-google-analytics/) +- Add [Hotjar](/manage-users/view-activity/hotjar/) +- Add Contentsquare ## Integrations - [Register your APIs](/developer-tools/your-apis/register-manage-apis/) on Kinde -- Connect to [Kinde’s Management API](/developer-tools/kinde-api/connect-to-kinde-api/) -- Add [Google Analytics](/manage-users/view-activity/track-user-sign-in-with-google-analytics/) to track user sign ups and sign ins -## Organizations (B2B/+ businesses) +## Do more with Kinde -- Learn how [multi-tenancy and organizations](/build/organizations/multi-tenancy-using-organizations/) works in Kinde -- Add or [import organizations](/build/organizations/import-organizations/) -- Allow [organization creation](/build/organizations/allow-org-create-on-signup/) on sign up -- [Apply branding for organizations](/design/brand/apply-branding-for-an-organization/) +- Use Kinde for your business model, learn how [multi-tenancy and organizations](/build/organizations/multi-tenancy-using-organizations/) works in Kinde +- Use [Kinde Billing](/billing/get-started/setup-overview/) to get paid from your customers From f6f189fa302bec78c49c627cc0235cbb3f8d4a26 Mon Sep 17 00:00:00 2001 From: Tamal Anwar Chowdhury Date: Mon, 27 Apr 2026 18:26:02 +0600 Subject: [PATCH 11/16] update the page restructure --- .../docs/get-started/guides/byo-code.mdx | 29 ++-- .../docs/get-started/guides/set-up-tasks.mdx | 135 ++++++++++++------ 2 files changed, 111 insertions(+), 53 deletions(-) diff --git a/src/content/docs/get-started/guides/byo-code.mdx b/src/content/docs/get-started/guides/byo-code.mdx index 7cea878e6..f49d62472 100644 --- a/src/content/docs/get-started/guides/byo-code.mdx +++ b/src/content/docs/get-started/guides/byo-code.mdx @@ -177,6 +177,18 @@ To create a test environment, do the following: Kinde free plan allows you to create only one non-production environment. If you want to create more (e.g., dev, staging), you will need a paid plan. See [Kinde pricing](https://kinde.com/pricing/) for more details. +### Register your APIs + +If your app communicates with back-end APIs, register them with Kinde so they can be included in the `aud` claim of access tokens. + +1. Go to **Settings > Environment > APIs**. +2. Select **Add API**. +3. Enter an **API name** and **Audience** (a unique identifier — typically a short code or the API URL). +4. Select **Save**. +5. Select **Applications** in the left menu, then select the three dots next to the relevant app and choose **Authorize application**. + +See the full [Register and manage APIs guide](/developer-tools/your-apis/register-manage-apis/) for token request examples and managing scopes. + ### Use Kinde Management API to automate admin tasks The Kinde Management API lets you automate admin tasks such as managing users, roles, permissions, and applications. To get started: @@ -191,21 +203,18 @@ The Kinde Management API lets you automate admin tasks such as managing users, r See the full [Kinde Management API reference](/kinde-apis/management/) for available endpoints and usage examples. -### Copy application configuration across environments - -Because Kinde environments are isolated and changes don't auto-promote, you need to manage your configuration as code. You can use a seeding script with the Kinde Management API to replicate application settings, such as connections, roles, and permissions consistently across dev, staging, and production. [See the guide for managing Kinde configuration via API](/developer-tools/guides/manage-kinde-configuration/). - -### End to end testing your Kinde apps - -Kinde supports automated testing for authentication flows, protected features, and backend API endpoints. You can use browser automation tools like Playwright or Cypress to test sign-up, sign-in, and sign-out flows, or use refresh tokens to test protected API routes without a browser. - -[See the end-to-end testing overview](/testing/) for setup instructions and implementation guides for each approach. - ### Deploy to production - [Prepare your production environment to go live](/build/environments/production-to-live/). - Deploy your app to: [Vercel](/developer-tools/guides/deploy-on-vercel/), [Netlify](/developer-tools/guides/deploy-on-netlify/) or [Cloudflare Workers](/developer-tools/guides/deploy-on-cloudflare-workers/). +## Advanced developer topics + +- [Customize with Workflows](/workflows/getting-started/quick-start-guide/) +- [Add and manage Webhooks](/integrate/webhooks/add-manage-webhooks/) +- [Copy configuration across environments](/developer-tools/guides/manage-kinde-configuration/) +- [End to end testing your Kinde apps](/testing/) + ## Next steps Make Kinde your own by: diff --git a/src/content/docs/get-started/guides/set-up-tasks.mdx b/src/content/docs/get-started/guides/set-up-tasks.mdx index 686131a9b..09bddbea7 100644 --- a/src/content/docs/get-started/guides/set-up-tasks.mdx +++ b/src/content/docs/get-started/guides/set-up-tasks.mdx @@ -13,6 +13,10 @@ description: Comprehensive guide to common Kinde setup tasks including business topics: - get-started - guides + - authentication + - branding + - user-management + - growth sdk: [] languages: [] audience: @@ -22,33 +26,43 @@ audience: complexity: intermediate keywords: - setup tasks - - business settings - - applications - - authentication - - user management - - integrations - - organizations + - authentication strategies + - social sign in + - enterprise connections + - custom domain + - email sender + - SMTP - branding -updated: 2024-01-15 + - user management + - import users + - user roles + - user permissions + - lead generation + - request access + - subscription form + - analytics + - UTM tags + - sign-in page design +updated: 2026-04-27 featured: false deprecated: false -ai_summary: Comprehensive guide to common Kinde setup tasks including business settings, applications, authentication, user management, and integrations. +ai_summary: "This guide covers the most common Kinde setup tasks across four areas. Core setup walks you through choosing authentication strategies — such as email, phone, or social sign-in — and configuring enterprise connections like Microsoft Entra ID and SAML. Branding and customization covers how to update your hosted auth pages, add a custom domain, configure your email sender with custom SMTP, and remove Kinde branding on paid plans. User management explains how to add or import users from platforms like Auth0, Clerk, or Firebase, and how to set up role-based access control with permissions and roles. Growth tools cover building a mailing list using a hosted request access page or an embeddable subscription form, and adding third-party analytics or UTM tags to your auth flows." --- -The whole idea of Kinde is you can set it up the way you want, without too much fuss. +Kinde is designed to fit the way you work — not the other way around. You have full control over how users authenticate, what your brand looks like, and how your app is structured. -Here are some common set up tasks. Depending on your business structure and how you want to do things, you may do some or all. +Here are the most common setup tasks. Depending on your business structure and goals, you may complete some or all of them. ### What you need - A [Kinde](https://kinde.com) account with **Admin** access (sign up for free) - Familiarity with auth strategies and user management -## Change the log in experience +## Core setup ### Change authentication strategies -By default, Kinde uses **Email + code** authentication strategy for user sign up and sign in. You can add different auth strategies for your app such as: +By default, Kinde uses the **Email + code** authentication strategy for user sign-up and sign-in. You can enable different strategies for your app, including: - Email + code (default) - Phone or WhatsApp auth @@ -58,13 +72,13 @@ By default, Kinde uses **Email + code** authentication strategy for user sign up ![kinde auth strategies](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/7b866fcb-0b23-4ebf-bb66-5176d66b6900/socialsharingimage) -Here is a general guide to configure the authentication strategies: +To configure an authentication strategy: 1. Go to your application > **View details** > **Authentication**. 2. Enable the authentication strategy you want to use. 3. Select **Save**. -If you want to use phone or WhatsApp connections, you will need to configure these services with Kinde. Take a look at the [authentication methods](/authenticate/authentication-methods/set-up-user-authentication/) page for more details and setup instructions for each. +If you want to use phone or WhatsApp connections, you'll need to configure those services separately. See the [authentication methods](/authenticate/authentication-methods/set-up-user-authentication/) page for details and setup instructions for each.