Skip to content
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 34 additions & 17 deletions src/content/docs/build/environments/environments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,46 +9,63 @@ app_context:
- m: environments
---

Kinde allows you to run multiple environments to support your software development cycle. By default, Kinde comes with a production environment, but you can create other environments, such as staging, testing, beta, etc. to meet your team’s needs.
Kinde allows you to run multiple environments to support your software development cycle. All plans come with one production environment and one non-production environment. Higher plans come with additional non-production environments, so you can add staging, testing, beta, etc. to meet your team’s needs.

Caution: Make sure you use the first environment (the one you got when you first sign up to Kinde) as your production environment. This is important for when you are [ready to go live](/build/environments/production-to-live/).
<Aside>

You can see the environment at the top of every page when signed in.
You must use the default production environment (the one you got when you first signed up to Kinde) as your production environment. This is important for when you are [ready to go live](/build/environments/production-to-live/). You cannot delete the production environment or add additional production environments.

## **Take care using multiple environments**
</Aside>

You can see the environment you are working in at the top left of the home page when signed in.

## Take care using multiple environments

Unless you are a developer, we recommend you stay in the production environment for viewing and working with your Kinde account.

For developers who want to test new user configurations or make other changes, do this in a testing or staging environment first, before replicating in the production environment.
For developers who want to test new user configurations or make other changes, do this in a non-production (testing or staging) environment first, before replicating in the production environment.

## Rate limiting for live production environments

Before you make your production environment live, [follow ](/build/environments/production-to-live/)[this checklist](/build/environments/production-to-live/).

The most important item being to ensure any [third-party authentication](/authenticate/authentication-methods/set-up-user-authentication/) connections (such as social connections or enterprise connections) are set up with the third-party’s Client ID and Client secret. If you leave these fields blank during setup, Kinde’s credentials will be used used as a proxy, and rate limits will apply.
It is critical that all [third-party authentication](/authenticate/authentication-methods/set-up-user-authentication/) connections (such as social connections or enterprise connections) are set up with the third-party’s Client ID and Client secret. If you leave these fields blank during setup, Kinde’s credentials will be used used as a proxy, and rate limits will apply.

Note that you can leave these fields blank in your non-production environments. Non-production environments cannot be made live.

## **View and manage environments**
## View and manage environments

Select the environment drop-down in the top left of the home screen. From here you can:
- Switch to another environment
- View all your environments (and create additional ones)
- View environment settings

## Add an environment

Select **Switch environments** from the **Environment** menu at the top of the screen. The **Environments** page opens showing your current and other environments.
You can only add non-production environments.

## **Add an environment**
1. Select the environment drop-down in the top left of the home screen, and select **All environments**.
2. On the **Environments** page, select **Add environment**.
3. Enter a name and code for the environment, then select **Save**.

On the **Environments** page, select **Add environment**. Enter a name and code for the environment, then select **Save**.
## Switch between environments

## **Switch between environments**
Select the environment drop-down in the top left of the home screen, and select the environment you want to switch to.

On the **Environments** page, switch to an environment by selecting **Switch to this environment**.
## Change the name of an environment

## **Edit environments**
1. Switch to the environment you want.
2. Select the environment drop-down in the top left of the home screen and choose **Environment settings**.
3. Change the environment name and select **Save**.

On the **Environments** page, select the three dots (…) in the top right corner of the environment you want to edit. Make your changes and select **Save**.
## Delete a non-production environment

## Delete an environment
You cannot delete the production environment.

1. On the **Environments** page, select the three dots (…) in the top right corner of the environment you want to delete.
2. Select **Delete environment**.
1. Select the environment drop-down in the top left of the home screen, and select **All environments**.
2. On the environment you want to delete select the three dots, then select **Delete environment**.
3. Confirm you want to delete the environment. This action is irreversible.

## Move data between environments

There is currently no way to shift data or configuration settings between environments. For now, you need to replicate settings manually, and export/import data or use the [Kinde Management API](https://docs.kinde.com/kinde-apis/management/). It's on our roadmap to make this easier someday.
Original file line number Diff line number Diff line change
Expand Up @@ -16,19 +16,21 @@ You can run multiple businesses on Kinde. This is helpful if you want to create

## **Add a new business**

1. In the **Business** menu at the top of the page, choose **Switch** **business.**
2. Select **Add business**.
3. Complete the form, including your preferred Kinde domain.
4. Select a **Region**. This is where your data is stored on Kinde.
1. Select your profile in the bottom left of the Kinde home screen.
2. From the menu, select **Switch business*. A screen showing all your businesses opens.
3. Select **Add business**.
4. Complete the form, including your preferred Kinde domain and data storage region. These details cannot be changed later.
5. Select **Save**.
6. To complete the setup, select the business to switch to it. Follow the quickstart prompts.

## **Switch between businesses**

1. In the **Business** menu at the top of the page, choose **Switch** **business.**
2. Select the business you want to work on.
1. Select your profile in the bottom left of the Kinde home screen.
2. From the menu, select **Switch business*. A screen showing all your businesses opens.
3. Select the one you want to work in. The business loads.

## Delete a business

You can only [delete your own business](/manage-your-account/your-data/delete-business/) if you are on a free plan. You need to email [support@kinde.com](mailto:support@kinde.com) to downgrade from a paid account before deleting.
You can only [delete a business](/manage-your-account/your-data/delete-business/) that is on the Kinde free plan. If you have a paid subscription, you need to email [support@kinde.com](mailto:support@kinde.com) to downgrade from a paid account before deleting. Include the Kinde domain and business name in the email, and send it from the owner account email.

Deleting a business is a nuclear and irreversible action, so make sure you export all your important data before doing this.
Deleting a business is a nuclear and irreversible action, so make sure you [export](/manage-your-account/your-data/exporting-data/) all your important data before doing this.
10 changes: 0 additions & 10 deletions src/content/docs/design/pages/page-layout.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,16 +32,6 @@ After you’ve set the global brand, view how it looks on individual pages, and

</Aside>

<img
src="https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/cc9ef0ab-51fc-4302-3a96-0273eaae6900/public"
alt=""
width="672px"
height="auto"
fetchpriority="low"
loading="lazy"
decoding="async"
/>

## Other cusomizations you might want to apply

- [Use your own domain instead of Kinde’s](/build/domains/pointing-your-domain/)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ People who customize pages also like to [use their own domain instead of Kinde
3. Enter the **Success link URL**.
4. Select **Preview** to view how the page will look.
5. Once you like it, switch the **Page details** button to **Live** and then select **Save**.
6. To change the content on the page, go to **Page content** in the menu, and select the *Request access** page.
6. To change the content on the page, go to **Page content** in the menu, and select the **Request access** page.
7. Make the changes you want in all the relevant languages and **Save**.
8. You'll need to separately set up the **Request Access URL** on your website.

Expand Down
42 changes: 8 additions & 34 deletions src/content/docs/get-started/guides/first-things-first.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,53 +21,27 @@ When you sign up for a new business, you’ll be guided through a few decisions

Then you’ll be asked if you want to use the Quick Start method to get your app connected.

<img
src="https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/52d876f0-afc1-4f56-0c05-992c7f7a2800/public"
alt=""
width="672px"
height="auto"
fetchpriority="low"
loading="lazy"
decoding="async"
/>
![quickstart example](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/52d876f0-afc1-4f56-0c05-992c7f7a2800/public)

## Take the Quick Start path

Follow our **Quick Start** guide to get connected fast.

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.

1. On the Kinde home page, select **Quick start** on your app tile.
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.**

<img
src="https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/6261642c-ebb2-471a-1d90-5056ad9dc400/public"
alt=""
width="672px"
height="auto"
fetchpriority="low"
loading="lazy"
decoding="async"
/>
![Tab selection options](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/31311feb-d809-4d04-ab91-6986f4b1b000/public)

2. Select the relevant tab: **Starter kit** or **Existing codebase.**

<img
src="https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/31311feb-d809-4d04-ab91-6986f4b1b000/public"
alt=""
width="672px"
height="auto"
fetchpriority="low"
loading="lazy"
decoding="async"
/>

3. Follow the steps to get connected!
4. Follow the steps to get connected!

If you need to, you can also change the technology you selected.

<Aside>

You can access the **Quick start** guide for any of your applications. Go to **Settings** > **Applications** > **Details** > **Quick start.**
You can access the **Quick start** guide for any of your applications. Go to **Settings** > **Applications** > **View details** (on the application tile) > **Quick start.**

</Aside>

Expand All @@ -79,6 +53,6 @@ If you need help setting up, there’s a **#support** channel in the Slack commu

## More starter docs

- All our SDKs
- [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/)
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ You can change some business details in Kinde, but you may need to contact suppo

## Change your sign in name

1. In Kinde, go to the top right corner and select your avatar.
1. In Kinde, go to the bottom-left of screen and select your avatar.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@clairekinde11 not sure if we want to mention but this is now only possible from the Home page. Same as Business and Env switching, only lives on Home.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@clairekinde11 I'm unsure if we have anything in the docs on the "Upgrade to Pro" CTA, but that also only resides on the homepage now, which is this point here.

There's also this change, which is a notable difference. However, I don't know if we mention that anywhere in the docs.

Copy link
Contributor Author

@clairekinde11 clairekinde11 Feb 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @DaveOrDead I'll update to say "On the home page in Kinde, ...."
Thanks @chris-pearce The upgrade topic is still correct, so no change required on point one. On second point, I would usually only say 'Select Save'. There could be a couple of places where I say "scroll down the page and Save. " but I could not find these from searching. I will fix if I see one.

2. In the menu that opens, select **Account details**.
3. Make the changes you want and select **Save**.

Expand Down