From f67d134ad7577f51e23ae32d2555c4ef2fe8ea59 Mon Sep 17 00:00:00 2001 From: connor Date: Fri, 9 Aug 2024 01:14:09 -0500 Subject: [PATCH 1/2] Add upgrade supertokens page. --- v2/community/sdks.mdx | 4 ++ v2/community/upgrading-supertokens.mdx | 64 +++++++++++++++++++ v2/emailpassword/sdks.mdx | 4 ++ v2/emailpassword/sidebars.js | 3 +- v2/emailpassword/upgrading-supertokens.mdx | 64 +++++++++++++++++++ v2/passwordless/sdks.mdx | 4 ++ v2/passwordless/sidebars.js | 3 +- v2/passwordless/upgrading-supertokens.mdx | 64 +++++++++++++++++++ v2/session/sdks.mdx | 4 ++ v2/session/sidebars.js | 3 +- v2/session/upgrading-supertokens.mdx | 64 +++++++++++++++++++ v2/thirdparty/sdks.mdx | 4 ++ v2/thirdparty/sidebars.js | 3 +- v2/thirdparty/upgrading-supertokens.mdx | 64 +++++++++++++++++++ v2/thirdpartyemailpassword/sdks.mdx | 4 ++ v2/thirdpartyemailpassword/sidebars.js | 3 +- .../upgrading-supertokens.mdx | 64 +++++++++++++++++++ v2/thirdpartypasswordless/sdks.mdx | 4 ++ v2/thirdpartypasswordless/sidebars.js | 3 +- .../upgrading-supertokens.mdx | 64 +++++++++++++++++++ 20 files changed, 488 insertions(+), 6 deletions(-) create mode 100644 v2/community/upgrading-supertokens.mdx create mode 100644 v2/emailpassword/upgrading-supertokens.mdx create mode 100644 v2/passwordless/upgrading-supertokens.mdx create mode 100644 v2/session/upgrading-supertokens.mdx create mode 100644 v2/thirdparty/upgrading-supertokens.mdx create mode 100644 v2/thirdpartyemailpassword/upgrading-supertokens.mdx create mode 100644 v2/thirdpartypasswordless/upgrading-supertokens.mdx diff --git a/v2/community/sdks.mdx b/v2/community/sdks.mdx index 55ad26806..51943bd13 100644 --- a/v2/community/sdks.mdx +++ b/v2/community/sdks.mdx @@ -60,6 +60,10 @@ import GuidesLink from "/src/components/guidesLink" - SuperTokens provides React based pre-built UI components, for other frontend frameworks you will need to build custom UI and use the `supertokens-web-js` SDK to communicate with the APIs exposed by the SuperTokens backend SDK. - For other backend frameworks, you can follow our [guide on how to spin up a separate server configured with the SuperTokens backend SDK](/docs/community/other-frameworks) to authenticate requests and issue session tokens. +## SDK Migration + +See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. + :::info Visit the [API reference page](./apis) to learn more. ::: \ No newline at end of file diff --git a/v2/community/upgrading-supertokens.mdx b/v2/community/upgrading-supertokens.mdx new file mode 100644 index 000000000..016374b27 --- /dev/null +++ b/v2/community/upgrading-supertokens.mdx @@ -0,0 +1,64 @@ +--- +id: upgrading-supertokens +title: Upgrading Supertokens core and SDKs +hide_title: true +--- + + + + +# Upgrading SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly upgrade supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. + +## 1. Upgrade your core + +You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween +your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible +with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. +Otherwise, please leave your core offline as you continue to upgrade your other SDK's. + +- ### Self-hosted core +[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. + +## 2. Upgrade your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) + +- ### GoLang +[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) + +- ### Python +[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) + +## 3. Upgrade your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) + +- ### Vanilla JS +[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) + +- ### React Native +[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) + +- ### iOS +[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) + +- ### Flutter +[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) + +- ### Android +[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) \ No newline at end of file diff --git a/v2/emailpassword/sdks.mdx b/v2/emailpassword/sdks.mdx index b155f32f5..351f3a41b 100644 --- a/v2/emailpassword/sdks.mdx +++ b/v2/emailpassword/sdks.mdx @@ -60,6 +60,10 @@ import GuidesLink from "/src/components/guidesLink" - SuperTokens provides React based pre-built UI components, for other frontend frameworks you will need to build custom UI and use the `supertokens-web-js` SDK to communicate with the APIs exposed by the SuperTokens backend SDK. - For other backend frameworks, you can follow our [guide on how to spin up a separate server configured with the SuperTokens backend SDK](/docs/community/other-frameworks) to authenticate requests and issue session tokens. +## SDK Migration + +See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. + :::info Visit the [API reference page](./apis) to learn more. ::: diff --git a/v2/emailpassword/sidebars.js b/v2/emailpassword/sidebars.js index eebacc885..f299972a8 100644 --- a/v2/emailpassword/sidebars.js +++ b/v2/emailpassword/sidebars.js @@ -719,7 +719,7 @@ module.exports = { }, { type: 'category', - label: 'Migration', + label: 'Migrating to Supertokens', items: [ "migration/about", { @@ -737,6 +737,7 @@ module.exports = { "migration/mfa-migration" ], }, + "upgrading-supertokens", { type: "category", label: "References", diff --git a/v2/emailpassword/upgrading-supertokens.mdx b/v2/emailpassword/upgrading-supertokens.mdx new file mode 100644 index 000000000..c46d3cbf2 --- /dev/null +++ b/v2/emailpassword/upgrading-supertokens.mdx @@ -0,0 +1,64 @@ +--- +id: upgrading-supertokens +title: Upgrading SuperTokens core and SDKs +hide_title: true +--- + + + + +# Upgrading SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly upgrade supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. + +## 1. Upgrade your core + +You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween +your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible +with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. +Otherwise, please leave your core offline as you continue to upgrade your other SDK's. + +- ### Self-hosted core +[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. + +## 2. Upgrade your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) + +- ### GoLang +[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) + +- ### Python +[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) + +## 3. Upgrade your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) + +- ### Vanilla JS +[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) + +- ### React Native +[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) + +- ### iOS +[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) + +- ### Flutter +[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) + +- ### Android +[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/passwordless/sdks.mdx b/v2/passwordless/sdks.mdx index b155f32f5..351f3a41b 100644 --- a/v2/passwordless/sdks.mdx +++ b/v2/passwordless/sdks.mdx @@ -60,6 +60,10 @@ import GuidesLink from "/src/components/guidesLink" - SuperTokens provides React based pre-built UI components, for other frontend frameworks you will need to build custom UI and use the `supertokens-web-js` SDK to communicate with the APIs exposed by the SuperTokens backend SDK. - For other backend frameworks, you can follow our [guide on how to spin up a separate server configured with the SuperTokens backend SDK](/docs/community/other-frameworks) to authenticate requests and issue session tokens. +## SDK Migration + +See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. + :::info Visit the [API reference page](./apis) to learn more. ::: diff --git a/v2/passwordless/sidebars.js b/v2/passwordless/sidebars.js index 48dce0c3a..9abdb6136 100644 --- a/v2/passwordless/sidebars.js +++ b/v2/passwordless/sidebars.js @@ -696,7 +696,7 @@ module.exports = { }, { type: 'category', - label: 'Migration', + label: 'Migrating to Supertokens', items: [ "migration/about", { @@ -713,6 +713,7 @@ module.exports = { "migration/mfa-migration" ], }, + "upgrading-supertokens", { type: "category", label: "References", diff --git a/v2/passwordless/upgrading-supertokens.mdx b/v2/passwordless/upgrading-supertokens.mdx new file mode 100644 index 000000000..c46d3cbf2 --- /dev/null +++ b/v2/passwordless/upgrading-supertokens.mdx @@ -0,0 +1,64 @@ +--- +id: upgrading-supertokens +title: Upgrading SuperTokens core and SDKs +hide_title: true +--- + + + + +# Upgrading SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly upgrade supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. + +## 1. Upgrade your core + +You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween +your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible +with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. +Otherwise, please leave your core offline as you continue to upgrade your other SDK's. + +- ### Self-hosted core +[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. + +## 2. Upgrade your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) + +- ### GoLang +[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) + +- ### Python +[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) + +## 3. Upgrade your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) + +- ### Vanilla JS +[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) + +- ### React Native +[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) + +- ### iOS +[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) + +- ### Flutter +[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) + +- ### Android +[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/session/sdks.mdx b/v2/session/sdks.mdx index b155f32f5..351f3a41b 100644 --- a/v2/session/sdks.mdx +++ b/v2/session/sdks.mdx @@ -60,6 +60,10 @@ import GuidesLink from "/src/components/guidesLink" - SuperTokens provides React based pre-built UI components, for other frontend frameworks you will need to build custom UI and use the `supertokens-web-js` SDK to communicate with the APIs exposed by the SuperTokens backend SDK. - For other backend frameworks, you can follow our [guide on how to spin up a separate server configured with the SuperTokens backend SDK](/docs/community/other-frameworks) to authenticate requests and issue session tokens. +## SDK Migration + +See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. + :::info Visit the [API reference page](./apis) to learn more. ::: diff --git a/v2/session/sidebars.js b/v2/session/sidebars.js index 196ffc7ea..72e5b691c 100644 --- a/v2/session/sidebars.js +++ b/v2/session/sidebars.js @@ -315,11 +315,12 @@ module.exports = { }, { type: 'category', - label: 'Migration', + label: 'Migrating to SuperTokens', items: [ "migration/session-migration", ], }, + "upgrading-supertokens", { type: "category", label: "References", diff --git a/v2/session/upgrading-supertokens.mdx b/v2/session/upgrading-supertokens.mdx new file mode 100644 index 000000000..c46d3cbf2 --- /dev/null +++ b/v2/session/upgrading-supertokens.mdx @@ -0,0 +1,64 @@ +--- +id: upgrading-supertokens +title: Upgrading SuperTokens core and SDKs +hide_title: true +--- + + + + +# Upgrading SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly upgrade supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. + +## 1. Upgrade your core + +You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween +your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible +with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. +Otherwise, please leave your core offline as you continue to upgrade your other SDK's. + +- ### Self-hosted core +[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. + +## 2. Upgrade your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) + +- ### GoLang +[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) + +- ### Python +[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) + +## 3. Upgrade your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) + +- ### Vanilla JS +[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) + +- ### React Native +[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) + +- ### iOS +[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) + +- ### Flutter +[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) + +- ### Android +[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/thirdparty/sdks.mdx b/v2/thirdparty/sdks.mdx index b155f32f5..351f3a41b 100644 --- a/v2/thirdparty/sdks.mdx +++ b/v2/thirdparty/sdks.mdx @@ -60,6 +60,10 @@ import GuidesLink from "/src/components/guidesLink" - SuperTokens provides React based pre-built UI components, for other frontend frameworks you will need to build custom UI and use the `supertokens-web-js` SDK to communicate with the APIs exposed by the SuperTokens backend SDK. - For other backend frameworks, you can follow our [guide on how to spin up a separate server configured with the SuperTokens backend SDK](/docs/community/other-frameworks) to authenticate requests and issue session tokens. +## SDK Migration + +See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. + :::info Visit the [API reference page](./apis) to learn more. ::: diff --git a/v2/thirdparty/sidebars.js b/v2/thirdparty/sidebars.js index 92976353c..b737b482a 100644 --- a/v2/thirdparty/sidebars.js +++ b/v2/thirdparty/sidebars.js @@ -708,7 +708,7 @@ module.exports = { }, { type: 'category', - label: 'Migration', + label: 'Migrating to Supertokens', items: [ "migration/about", { @@ -725,6 +725,7 @@ module.exports = { "migration/mfa-migration" ], }, + "upgrading-supertokens", { type: "category", label: "References", diff --git a/v2/thirdparty/upgrading-supertokens.mdx b/v2/thirdparty/upgrading-supertokens.mdx new file mode 100644 index 000000000..c46d3cbf2 --- /dev/null +++ b/v2/thirdparty/upgrading-supertokens.mdx @@ -0,0 +1,64 @@ +--- +id: upgrading-supertokens +title: Upgrading SuperTokens core and SDKs +hide_title: true +--- + + + + +# Upgrading SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly upgrade supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. + +## 1. Upgrade your core + +You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween +your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible +with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. +Otherwise, please leave your core offline as you continue to upgrade your other SDK's. + +- ### Self-hosted core +[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. + +## 2. Upgrade your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) + +- ### GoLang +[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) + +- ### Python +[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) + +## 3. Upgrade your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) + +- ### Vanilla JS +[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) + +- ### React Native +[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) + +- ### iOS +[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) + +- ### Flutter +[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) + +- ### Android +[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/thirdpartyemailpassword/sdks.mdx b/v2/thirdpartyemailpassword/sdks.mdx index b155f32f5..351f3a41b 100644 --- a/v2/thirdpartyemailpassword/sdks.mdx +++ b/v2/thirdpartyemailpassword/sdks.mdx @@ -60,6 +60,10 @@ import GuidesLink from "/src/components/guidesLink" - SuperTokens provides React based pre-built UI components, for other frontend frameworks you will need to build custom UI and use the `supertokens-web-js` SDK to communicate with the APIs exposed by the SuperTokens backend SDK. - For other backend frameworks, you can follow our [guide on how to spin up a separate server configured with the SuperTokens backend SDK](/docs/community/other-frameworks) to authenticate requests and issue session tokens. +## SDK Migration + +See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. + :::info Visit the [API reference page](./apis) to learn more. ::: diff --git a/v2/thirdpartyemailpassword/sidebars.js b/v2/thirdpartyemailpassword/sidebars.js index 3f63f2bfb..9ec45edd2 100644 --- a/v2/thirdpartyemailpassword/sidebars.js +++ b/v2/thirdpartyemailpassword/sidebars.js @@ -757,7 +757,7 @@ module.exports = { }, { type: 'category', - label: 'Migration', + label: 'Migrating to Supertokens', items: [ "migration/about", { @@ -775,6 +775,7 @@ module.exports = { "migration/mfa-migration" ], }, + "upgrading-supertokens", { type: "category", label: "References", diff --git a/v2/thirdpartyemailpassword/upgrading-supertokens.mdx b/v2/thirdpartyemailpassword/upgrading-supertokens.mdx new file mode 100644 index 000000000..c46d3cbf2 --- /dev/null +++ b/v2/thirdpartyemailpassword/upgrading-supertokens.mdx @@ -0,0 +1,64 @@ +--- +id: upgrading-supertokens +title: Upgrading SuperTokens core and SDKs +hide_title: true +--- + + + + +# Upgrading SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly upgrade supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. + +## 1. Upgrade your core + +You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween +your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible +with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. +Otherwise, please leave your core offline as you continue to upgrade your other SDK's. + +- ### Self-hosted core +[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. + +## 2. Upgrade your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) + +- ### GoLang +[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) + +- ### Python +[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) + +## 3. Upgrade your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) + +- ### Vanilla JS +[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) + +- ### React Native +[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) + +- ### iOS +[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) + +- ### Flutter +[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) + +- ### Android +[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/thirdpartypasswordless/sdks.mdx b/v2/thirdpartypasswordless/sdks.mdx index b155f32f5..351f3a41b 100644 --- a/v2/thirdpartypasswordless/sdks.mdx +++ b/v2/thirdpartypasswordless/sdks.mdx @@ -60,6 +60,10 @@ import GuidesLink from "/src/components/guidesLink" - SuperTokens provides React based pre-built UI components, for other frontend frameworks you will need to build custom UI and use the `supertokens-web-js` SDK to communicate with the APIs exposed by the SuperTokens backend SDK. - For other backend frameworks, you can follow our [guide on how to spin up a separate server configured with the SuperTokens backend SDK](/docs/community/other-frameworks) to authenticate requests and issue session tokens. +## SDK Migration + +See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. + :::info Visit the [API reference page](./apis) to learn more. ::: diff --git a/v2/thirdpartypasswordless/sidebars.js b/v2/thirdpartypasswordless/sidebars.js index 9c86a13ec..9b5b42f0d 100644 --- a/v2/thirdpartypasswordless/sidebars.js +++ b/v2/thirdpartypasswordless/sidebars.js @@ -749,7 +749,7 @@ module.exports = { }, { type: 'category', - label: 'Migration', + label: 'Migrating to Supertokens', items: [ "migration/about", { @@ -766,6 +766,7 @@ module.exports = { "migration/mfa-migration" ], }, + "upgrading-supertokens", { type: "category", label: "References", diff --git a/v2/thirdpartypasswordless/upgrading-supertokens.mdx b/v2/thirdpartypasswordless/upgrading-supertokens.mdx new file mode 100644 index 000000000..c46d3cbf2 --- /dev/null +++ b/v2/thirdpartypasswordless/upgrading-supertokens.mdx @@ -0,0 +1,64 @@ +--- +id: upgrading-supertokens +title: Upgrading SuperTokens core and SDKs +hide_title: true +--- + + + + +# Upgrading SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly upgrade supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. + +## 1. Upgrade your core + +You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween +your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible +with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. +Otherwise, please leave your core offline as you continue to upgrade your other SDK's. + +- ### Self-hosted core +[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. + +## 2. Upgrade your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) + +- ### GoLang +[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) + +- ### Python +[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) + +## 3. Upgrade your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) + +- ### Vanilla JS +[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) + +- ### React Native +[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) + +- ### iOS +[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) + +- ### Flutter +[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) + +- ### Android +[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) From 2dd25c631d028ba39708018fc8a49ef539cef46a Mon Sep 17 00:00:00 2001 From: connor Date: Fri, 16 Aug 2024 06:36:19 -0400 Subject: [PATCH 2/2] update wording and fix links. --- v2/community/sdks.mdx | 2 +- v2/community/updating-supertokens.mdx | 65 +++++++++++++++++++ v2/community/upgrading-supertokens.mdx | 64 ------------------ v2/emailpassword/sdks.mdx | 2 +- v2/emailpassword/sidebars.js | 2 +- v2/emailpassword/updating-supertokens.mdx | 65 +++++++++++++++++++ v2/emailpassword/upgrading-supertokens.mdx | 64 ------------------ v2/passwordless/sdks.mdx | 2 +- v2/passwordless/sidebars.js | 2 +- v2/passwordless/updating-supertokens.mdx | 65 +++++++++++++++++++ v2/passwordless/upgrading-supertokens.mdx | 64 ------------------ v2/session/sdks.mdx | 2 +- v2/session/sidebars.js | 2 +- v2/session/updating-supertokens.mdx | 65 +++++++++++++++++++ v2/session/upgrading-supertokens.mdx | 64 ------------------ v2/thirdparty/sdks.mdx | 2 +- v2/thirdparty/sidebars.js | 2 +- v2/thirdparty/updating-supertokens.mdx | 65 +++++++++++++++++++ v2/thirdparty/upgrading-supertokens.mdx | 64 ------------------ v2/thirdpartyemailpassword/sdks.mdx | 2 +- v2/thirdpartyemailpassword/sidebars.js | 2 +- .../updating-supertokens.mdx | 65 +++++++++++++++++++ .../upgrading-supertokens.mdx | 64 ------------------ v2/thirdpartypasswordless/sdks.mdx | 2 +- v2/thirdpartypasswordless/sidebars.js | 2 +- .../updating-supertokens.mdx | 65 +++++++++++++++++++ .../upgrading-supertokens.mdx | 64 ------------------ 27 files changed, 468 insertions(+), 461 deletions(-) create mode 100644 v2/community/updating-supertokens.mdx delete mode 100644 v2/community/upgrading-supertokens.mdx create mode 100644 v2/emailpassword/updating-supertokens.mdx delete mode 100644 v2/emailpassword/upgrading-supertokens.mdx create mode 100644 v2/passwordless/updating-supertokens.mdx delete mode 100644 v2/passwordless/upgrading-supertokens.mdx create mode 100644 v2/session/updating-supertokens.mdx delete mode 100644 v2/session/upgrading-supertokens.mdx create mode 100644 v2/thirdparty/updating-supertokens.mdx delete mode 100644 v2/thirdparty/upgrading-supertokens.mdx create mode 100644 v2/thirdpartyemailpassword/updating-supertokens.mdx delete mode 100644 v2/thirdpartyemailpassword/upgrading-supertokens.mdx create mode 100644 v2/thirdpartypasswordless/updating-supertokens.mdx delete mode 100644 v2/thirdpartypasswordless/upgrading-supertokens.mdx diff --git a/v2/community/sdks.mdx b/v2/community/sdks.mdx index 51943bd13..d5c8770a5 100644 --- a/v2/community/sdks.mdx +++ b/v2/community/sdks.mdx @@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink" ## SDK Migration -See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. +See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs. :::info Visit the [API reference page](./apis) to learn more. diff --git a/v2/community/updating-supertokens.mdx b/v2/community/updating-supertokens.mdx new file mode 100644 index 000000000..ad5a2ee0d --- /dev/null +++ b/v2/community/updating-supertokens.mdx @@ -0,0 +1,65 @@ +--- +id: updating-supertokens +title: Updating Supertokens core and SDKs +hide_title: true +--- + + + + +# Updating SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly update supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible. + +## 1. Updating your core + +You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween +your starting version and the latest version. You may then bring your core back online. + +In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and +back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them. + +- ### Self-hosted core +See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md). + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core update. + +## 2. Update your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md). + +- ### GoLang +See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md). + +- ### Python +See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md). + +## 3. Update your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md). + +- ### Vanilla JS +See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md). + +- ### React Native +See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md). + +- ### iOS +See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md). + +- ### Flutter +See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md). + +- ### Android +See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md). \ No newline at end of file diff --git a/v2/community/upgrading-supertokens.mdx b/v2/community/upgrading-supertokens.mdx deleted file mode 100644 index 016374b27..000000000 --- a/v2/community/upgrading-supertokens.mdx +++ /dev/null @@ -1,64 +0,0 @@ ---- -id: upgrading-supertokens -title: Upgrading Supertokens core and SDKs -hide_title: true ---- - - - - -# Upgrading SuperTokens core and SDKs - -:::important -You need to follow these steps in order to properly upgrade supertokens -::: - -In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. - -## 1. Upgrade your core - -You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween -your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible -with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. -Otherwise, please leave your core offline as you continue to upgrade your other SDK's. - -- ### Self-hosted core -[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) - -- ### Managed core -If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. - -## 2. Upgrade your back-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### NodeJS -[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) - -- ### GoLang -[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) - -- ### Python -[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) - -## 3. Upgrade your front-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### ReactJS -[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) - -- ### Vanilla JS -[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) - -- ### React Native -[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) - -- ### iOS -[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) - -- ### Flutter -[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) - -- ### Android -[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) \ No newline at end of file diff --git a/v2/emailpassword/sdks.mdx b/v2/emailpassword/sdks.mdx index 351f3a41b..a732bdfa0 100644 --- a/v2/emailpassword/sdks.mdx +++ b/v2/emailpassword/sdks.mdx @@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink" ## SDK Migration -See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. +See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs. :::info Visit the [API reference page](./apis) to learn more. diff --git a/v2/emailpassword/sidebars.js b/v2/emailpassword/sidebars.js index f299972a8..7a968b1c7 100644 --- a/v2/emailpassword/sidebars.js +++ b/v2/emailpassword/sidebars.js @@ -737,7 +737,7 @@ module.exports = { "migration/mfa-migration" ], }, - "upgrading-supertokens", + "updating-supertokens", { type: "category", label: "References", diff --git a/v2/emailpassword/updating-supertokens.mdx b/v2/emailpassword/updating-supertokens.mdx new file mode 100644 index 000000000..b57bab619 --- /dev/null +++ b/v2/emailpassword/updating-supertokens.mdx @@ -0,0 +1,65 @@ +--- +id: updating-supertokens +title: Updating Supertokens core and SDKs +hide_title: true +--- + + + + +# Updating SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly update supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible. + +## 1. Updating your core + +You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween +your starting version and the latest version. You may then bring your core back online. + +In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and +back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them. + +- ### Self-hosted core +See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md). + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core update. + +## 2. Update your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md). + +- ### GoLang +See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md). + +- ### Python +See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md). + +## 3. Update your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md). + +- ### Vanilla JS +See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md). + +- ### React Native +See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md). + +- ### iOS +See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md). + +- ### Flutter +See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md). + +- ### Android +See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md). diff --git a/v2/emailpassword/upgrading-supertokens.mdx b/v2/emailpassword/upgrading-supertokens.mdx deleted file mode 100644 index c46d3cbf2..000000000 --- a/v2/emailpassword/upgrading-supertokens.mdx +++ /dev/null @@ -1,64 +0,0 @@ ---- -id: upgrading-supertokens -title: Upgrading SuperTokens core and SDKs -hide_title: true ---- - - - - -# Upgrading SuperTokens core and SDKs - -:::important -You need to follow these steps in order to properly upgrade supertokens -::: - -In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. - -## 1. Upgrade your core - -You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween -your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible -with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. -Otherwise, please leave your core offline as you continue to upgrade your other SDK's. - -- ### Self-hosted core -[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) - -- ### Managed core -If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. - -## 2. Upgrade your back-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### NodeJS -[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) - -- ### GoLang -[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) - -- ### Python -[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) - -## 3. Upgrade your front-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### ReactJS -[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) - -- ### Vanilla JS -[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) - -- ### React Native -[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) - -- ### iOS -[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) - -- ### Flutter -[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) - -- ### Android -[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/passwordless/sdks.mdx b/v2/passwordless/sdks.mdx index 351f3a41b..a732bdfa0 100644 --- a/v2/passwordless/sdks.mdx +++ b/v2/passwordless/sdks.mdx @@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink" ## SDK Migration -See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. +See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs. :::info Visit the [API reference page](./apis) to learn more. diff --git a/v2/passwordless/sidebars.js b/v2/passwordless/sidebars.js index 9abdb6136..7f9bc1371 100644 --- a/v2/passwordless/sidebars.js +++ b/v2/passwordless/sidebars.js @@ -713,7 +713,7 @@ module.exports = { "migration/mfa-migration" ], }, - "upgrading-supertokens", + "updating-supertokens", { type: "category", label: "References", diff --git a/v2/passwordless/updating-supertokens.mdx b/v2/passwordless/updating-supertokens.mdx new file mode 100644 index 000000000..b57bab619 --- /dev/null +++ b/v2/passwordless/updating-supertokens.mdx @@ -0,0 +1,65 @@ +--- +id: updating-supertokens +title: Updating Supertokens core and SDKs +hide_title: true +--- + + + + +# Updating SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly update supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible. + +## 1. Updating your core + +You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween +your starting version and the latest version. You may then bring your core back online. + +In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and +back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them. + +- ### Self-hosted core +See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md). + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core update. + +## 2. Update your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md). + +- ### GoLang +See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md). + +- ### Python +See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md). + +## 3. Update your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md). + +- ### Vanilla JS +See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md). + +- ### React Native +See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md). + +- ### iOS +See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md). + +- ### Flutter +See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md). + +- ### Android +See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md). diff --git a/v2/passwordless/upgrading-supertokens.mdx b/v2/passwordless/upgrading-supertokens.mdx deleted file mode 100644 index c46d3cbf2..000000000 --- a/v2/passwordless/upgrading-supertokens.mdx +++ /dev/null @@ -1,64 +0,0 @@ ---- -id: upgrading-supertokens -title: Upgrading SuperTokens core and SDKs -hide_title: true ---- - - - - -# Upgrading SuperTokens core and SDKs - -:::important -You need to follow these steps in order to properly upgrade supertokens -::: - -In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. - -## 1. Upgrade your core - -You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween -your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible -with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. -Otherwise, please leave your core offline as you continue to upgrade your other SDK's. - -- ### Self-hosted core -[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) - -- ### Managed core -If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. - -## 2. Upgrade your back-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### NodeJS -[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) - -- ### GoLang -[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) - -- ### Python -[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) - -## 3. Upgrade your front-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### ReactJS -[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) - -- ### Vanilla JS -[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) - -- ### React Native -[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) - -- ### iOS -[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) - -- ### Flutter -[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) - -- ### Android -[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/session/sdks.mdx b/v2/session/sdks.mdx index 351f3a41b..a732bdfa0 100644 --- a/v2/session/sdks.mdx +++ b/v2/session/sdks.mdx @@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink" ## SDK Migration -See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. +See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs. :::info Visit the [API reference page](./apis) to learn more. diff --git a/v2/session/sidebars.js b/v2/session/sidebars.js index 72e5b691c..211fe0810 100644 --- a/v2/session/sidebars.js +++ b/v2/session/sidebars.js @@ -320,7 +320,7 @@ module.exports = { "migration/session-migration", ], }, - "upgrading-supertokens", + "updating-supertokens", { type: "category", label: "References", diff --git a/v2/session/updating-supertokens.mdx b/v2/session/updating-supertokens.mdx new file mode 100644 index 000000000..b57bab619 --- /dev/null +++ b/v2/session/updating-supertokens.mdx @@ -0,0 +1,65 @@ +--- +id: updating-supertokens +title: Updating Supertokens core and SDKs +hide_title: true +--- + + + + +# Updating SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly update supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible. + +## 1. Updating your core + +You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween +your starting version and the latest version. You may then bring your core back online. + +In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and +back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them. + +- ### Self-hosted core +See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md). + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core update. + +## 2. Update your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md). + +- ### GoLang +See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md). + +- ### Python +See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md). + +## 3. Update your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md). + +- ### Vanilla JS +See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md). + +- ### React Native +See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md). + +- ### iOS +See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md). + +- ### Flutter +See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md). + +- ### Android +See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md). diff --git a/v2/session/upgrading-supertokens.mdx b/v2/session/upgrading-supertokens.mdx deleted file mode 100644 index c46d3cbf2..000000000 --- a/v2/session/upgrading-supertokens.mdx +++ /dev/null @@ -1,64 +0,0 @@ ---- -id: upgrading-supertokens -title: Upgrading SuperTokens core and SDKs -hide_title: true ---- - - - - -# Upgrading SuperTokens core and SDKs - -:::important -You need to follow these steps in order to properly upgrade supertokens -::: - -In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. - -## 1. Upgrade your core - -You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween -your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible -with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. -Otherwise, please leave your core offline as you continue to upgrade your other SDK's. - -- ### Self-hosted core -[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) - -- ### Managed core -If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. - -## 2. Upgrade your back-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### NodeJS -[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) - -- ### GoLang -[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) - -- ### Python -[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) - -## 3. Upgrade your front-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### ReactJS -[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) - -- ### Vanilla JS -[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) - -- ### React Native -[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) - -- ### iOS -[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) - -- ### Flutter -[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) - -- ### Android -[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/thirdparty/sdks.mdx b/v2/thirdparty/sdks.mdx index 351f3a41b..a732bdfa0 100644 --- a/v2/thirdparty/sdks.mdx +++ b/v2/thirdparty/sdks.mdx @@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink" ## SDK Migration -See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. +See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs. :::info Visit the [API reference page](./apis) to learn more. diff --git a/v2/thirdparty/sidebars.js b/v2/thirdparty/sidebars.js index b737b482a..9d1c734f2 100644 --- a/v2/thirdparty/sidebars.js +++ b/v2/thirdparty/sidebars.js @@ -725,7 +725,7 @@ module.exports = { "migration/mfa-migration" ], }, - "upgrading-supertokens", + "updating-supertokens", { type: "category", label: "References", diff --git a/v2/thirdparty/updating-supertokens.mdx b/v2/thirdparty/updating-supertokens.mdx new file mode 100644 index 000000000..b57bab619 --- /dev/null +++ b/v2/thirdparty/updating-supertokens.mdx @@ -0,0 +1,65 @@ +--- +id: updating-supertokens +title: Updating Supertokens core and SDKs +hide_title: true +--- + + + + +# Updating SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly update supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible. + +## 1. Updating your core + +You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween +your starting version and the latest version. You may then bring your core back online. + +In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and +back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them. + +- ### Self-hosted core +See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md). + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core update. + +## 2. Update your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md). + +- ### GoLang +See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md). + +- ### Python +See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md). + +## 3. Update your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md). + +- ### Vanilla JS +See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md). + +- ### React Native +See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md). + +- ### iOS +See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md). + +- ### Flutter +See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md). + +- ### Android +See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md). diff --git a/v2/thirdparty/upgrading-supertokens.mdx b/v2/thirdparty/upgrading-supertokens.mdx deleted file mode 100644 index c46d3cbf2..000000000 --- a/v2/thirdparty/upgrading-supertokens.mdx +++ /dev/null @@ -1,64 +0,0 @@ ---- -id: upgrading-supertokens -title: Upgrading SuperTokens core and SDKs -hide_title: true ---- - - - - -# Upgrading SuperTokens core and SDKs - -:::important -You need to follow these steps in order to properly upgrade supertokens -::: - -In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. - -## 1. Upgrade your core - -You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween -your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible -with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. -Otherwise, please leave your core offline as you continue to upgrade your other SDK's. - -- ### Self-hosted core -[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) - -- ### Managed core -If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. - -## 2. Upgrade your back-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### NodeJS -[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) - -- ### GoLang -[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) - -- ### Python -[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) - -## 3. Upgrade your front-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### ReactJS -[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) - -- ### Vanilla JS -[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) - -- ### React Native -[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) - -- ### iOS -[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) - -- ### Flutter -[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) - -- ### Android -[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/thirdpartyemailpassword/sdks.mdx b/v2/thirdpartyemailpassword/sdks.mdx index 351f3a41b..a732bdfa0 100644 --- a/v2/thirdpartyemailpassword/sdks.mdx +++ b/v2/thirdpartyemailpassword/sdks.mdx @@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink" ## SDK Migration -See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. +See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs. :::info Visit the [API reference page](./apis) to learn more. diff --git a/v2/thirdpartyemailpassword/sidebars.js b/v2/thirdpartyemailpassword/sidebars.js index 9ec45edd2..1e222299f 100644 --- a/v2/thirdpartyemailpassword/sidebars.js +++ b/v2/thirdpartyemailpassword/sidebars.js @@ -775,7 +775,7 @@ module.exports = { "migration/mfa-migration" ], }, - "upgrading-supertokens", + "updating-supertokens", { type: "category", label: "References", diff --git a/v2/thirdpartyemailpassword/updating-supertokens.mdx b/v2/thirdpartyemailpassword/updating-supertokens.mdx new file mode 100644 index 000000000..b57bab619 --- /dev/null +++ b/v2/thirdpartyemailpassword/updating-supertokens.mdx @@ -0,0 +1,65 @@ +--- +id: updating-supertokens +title: Updating Supertokens core and SDKs +hide_title: true +--- + + + + +# Updating SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly update supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible. + +## 1. Updating your core + +You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween +your starting version and the latest version. You may then bring your core back online. + +In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and +back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them. + +- ### Self-hosted core +See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md). + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core update. + +## 2. Update your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md). + +- ### GoLang +See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md). + +- ### Python +See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md). + +## 3. Update your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md). + +- ### Vanilla JS +See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md). + +- ### React Native +See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md). + +- ### iOS +See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md). + +- ### Flutter +See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md). + +- ### Android +See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md). diff --git a/v2/thirdpartyemailpassword/upgrading-supertokens.mdx b/v2/thirdpartyemailpassword/upgrading-supertokens.mdx deleted file mode 100644 index c46d3cbf2..000000000 --- a/v2/thirdpartyemailpassword/upgrading-supertokens.mdx +++ /dev/null @@ -1,64 +0,0 @@ ---- -id: upgrading-supertokens -title: Upgrading SuperTokens core and SDKs -hide_title: true ---- - - - - -# Upgrading SuperTokens core and SDKs - -:::important -You need to follow these steps in order to properly upgrade supertokens -::: - -In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. - -## 1. Upgrade your core - -You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween -your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible -with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. -Otherwise, please leave your core offline as you continue to upgrade your other SDK's. - -- ### Self-hosted core -[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) - -- ### Managed core -If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. - -## 2. Upgrade your back-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### NodeJS -[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) - -- ### GoLang -[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) - -- ### Python -[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) - -## 3. Upgrade your front-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### ReactJS -[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) - -- ### Vanilla JS -[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) - -- ### React Native -[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) - -- ### iOS -[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) - -- ### Flutter -[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) - -- ### Android -[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md) diff --git a/v2/thirdpartypasswordless/sdks.mdx b/v2/thirdpartypasswordless/sdks.mdx index 351f3a41b..a732bdfa0 100644 --- a/v2/thirdpartypasswordless/sdks.mdx +++ b/v2/thirdpartypasswordless/sdks.mdx @@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink" ## SDK Migration -See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs. +See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs. :::info Visit the [API reference page](./apis) to learn more. diff --git a/v2/thirdpartypasswordless/sidebars.js b/v2/thirdpartypasswordless/sidebars.js index 9b5b42f0d..cad3a6d75 100644 --- a/v2/thirdpartypasswordless/sidebars.js +++ b/v2/thirdpartypasswordless/sidebars.js @@ -766,7 +766,7 @@ module.exports = { "migration/mfa-migration" ], }, - "upgrading-supertokens", + "updating-supertokens", { type: "category", label: "References", diff --git a/v2/thirdpartypasswordless/updating-supertokens.mdx b/v2/thirdpartypasswordless/updating-supertokens.mdx new file mode 100644 index 000000000..b57bab619 --- /dev/null +++ b/v2/thirdpartypasswordless/updating-supertokens.mdx @@ -0,0 +1,65 @@ +--- +id: updating-supertokens +title: Updating Supertokens core and SDKs +hide_title: true +--- + + + + +# Updating SuperTokens core and SDKs + +:::important +You need to follow these steps in order to properly update supertokens +::: + +In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible. + +## 1. Updating your core + +You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween +your starting version and the latest version. You may then bring your core back online. + +In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and +back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them. + +- ### Self-hosted core +See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md). + +- ### Managed core +If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core update. + +## 2. Update your back-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### NodeJS +See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md). + +- ### GoLang +See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md). + +- ### Python +See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md). + +## 3. Update your front-end SDK + +Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. + +- ### ReactJS +See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md). + +- ### Vanilla JS +See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md). + +- ### React Native +See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md). + +- ### iOS +See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md). + +- ### Flutter +See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md). + +- ### Android +See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md). diff --git a/v2/thirdpartypasswordless/upgrading-supertokens.mdx b/v2/thirdpartypasswordless/upgrading-supertokens.mdx deleted file mode 100644 index c46d3cbf2..000000000 --- a/v2/thirdpartypasswordless/upgrading-supertokens.mdx +++ /dev/null @@ -1,64 +0,0 @@ ---- -id: upgrading-supertokens -title: Upgrading SuperTokens core and SDKs -hide_title: true ---- - - - - -# Upgrading SuperTokens core and SDKs - -:::important -You need to follow these steps in order to properly upgrade supertokens -::: - -In order to maintain compatibility and keep up on new features, we recommend upgrading your core and SDKs whenever possible. - -## 1. Upgrade your core - -You will need to shut down your core in order to upgrade it. After it's off, run the migration scripts for all major versions inbetween -your starting version and the version you are upgrading to. If the supertokens core version you have upgraded to shows as compatible -with your current front-end and back-end sdk's in the [compatibility table](./compatibility-table), then you can bring your core back online. -Otherwise, please leave your core offline as you continue to upgrade your other SDK's. - -- ### Self-hosted core -[supertokens-core](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md) - -- ### Managed core -If you're using the managed core service, please email us at team@supertokens.com from your registered email to request a core upgrade. - -## 2. Upgrade your back-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### NodeJS -[supertokens-node](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md) - -- ### GoLang -[supertokens-golang](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md) - -- ### Python -[supertokens-python](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md) - -## 3. Upgrade your front-end SDK - -Follow the steps in the migration sections of the linked changelog from your current version up to the latest version. - -- ### ReactJS -[supertokens-auth-react](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md) - -- ### Vanilla JS -[supertokens-web-js](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md) - -- ### React Native -[supertokens-react-native](https://github.com/supertokens/supertokens-react-native) - -- ### iOS -[supertokens-ios](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md) - -- ### Flutter -[supertokens-flutter](https://github.com/supertokens/supertokens-flutter) - -- ### Android -[supertokens-android](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md)