diff --git a/versioned_docs/version-2.1/aws/advanced/certificates.mdx b/versioned_docs/version-2.1/aws/advanced/certificates.mdx
index fef03c29..af5e9e57 100644
--- a/versioned_docs/version-2.1/aws/advanced/certificates.mdx
+++ b/versioned_docs/version-2.1/aws/advanced/certificates.mdx
@@ -2,7 +2,7 @@
 title: Certificates
 ---
 
-import * as config from "@site/docs/constants.js"
+import * as config from "../../constants.js"
 
 <div
   style={{
diff --git a/versioned_docs/version-2.1/aws/advanced/install.mdx b/versioned_docs/version-2.1/aws/advanced/install.mdx
index f9fefe35..621dbc58 100644
--- a/versioned_docs/version-2.1/aws/advanced/install.mdx
+++ b/versioned_docs/version-2.1/aws/advanced/install.mdx
@@ -9,11 +9,10 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
-import ReactDom from 'react-dom'
-import * as config from "@site/docs/constants.js"
-import GitHubInstall from '@site/docs/aws/partials/github/_install.mdx'
-import GitLabInstall from '@site/docs/aws/partials/gitlab/_install.mdx'
+import styles from "../../stylesheets/tabs.module.css";
+import * as config from "../../constants.js"
+import GitHubInstall from '../partials/github/_install.mdx'
+import GitLabInstall from '../partials/gitlab/_install.mdx'
 
 <div
   style={{
diff --git a/versioned_docs/version-2.1/aws/advanced/security.mdx b/versioned_docs/version-2.1/aws/advanced/security.mdx
index 98bdbed9..26fc5a2a 100644
--- a/versioned_docs/version-2.1/aws/advanced/security.mdx
+++ b/versioned_docs/version-2.1/aws/advanced/security.mdx
@@ -2,7 +2,7 @@
 title: Security
 ---
 
-import * as config from "@site/docs/constants.js"
+import * as config from "../../constants.js"
 
 <div
   style={{
diff --git a/versioned_docs/version-2.1/aws/credits.mdx b/versioned_docs/version-2.1/aws/credits.mdx
index 186c6481..5bdc770e 100644
--- a/versioned_docs/version-2.1/aws/credits.mdx
+++ b/versioned_docs/version-2.1/aws/credits.mdx
@@ -6,6 +6,6 @@ description: how to destroy your kubefirst platform
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import Credits from "@site/docs/common/credits.mdx"
+import Credits from "../common/credits.mdx"
 
 <Credits />
diff --git a/versioned_docs/version-2.1/aws/deprovision.mdx b/versioned_docs/version-2.1/aws/deprovision.mdx
index f738c06f..139769e3 100644
--- a/versioned_docs/version-2.1/aws/deprovision.mdx
+++ b/versioned_docs/version-2.1/aws/deprovision.mdx
@@ -6,6 +6,6 @@ description: how to destroy your kubefirst platform
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import Deprovision from '@site/docs/common/deprovision.mdx'
+import Deprovision from '../common/deprovision.mdx'
 
 <Deprovision />
diff --git a/versioned_docs/version-2.1/aws/explore/argocd.mdx b/versioned_docs/version-2.1/aws/explore/argocd.mdx
index 9f4f59f0..9a09befa 100644
--- a/versioned_docs/version-2.1/aws/explore/argocd.mdx
+++ b/versioned_docs/version-2.1/aws/explore/argocd.mdx
@@ -3,6 +3,6 @@ title: Argo CD
 sidebar_position: 1
 ---
 
-import ExploreArgocd from "@site/docs/common/argocd.mdx"
+import ExploreArgocd from "../../common/argocd.mdx"
 
 <ExploreArgocd />
diff --git a/versioned_docs/version-2.1/aws/explore/gitops.mdx b/versioned_docs/version-2.1/aws/explore/gitops.mdx
index b1ac43cd..cfa55bbc 100644
--- a/versioned_docs/version-2.1/aws/explore/gitops.mdx
+++ b/versioned_docs/version-2.1/aws/explore/gitops.mdx
@@ -4,6 +4,6 @@ sidebar_position: 2
 ---
 
 
-import ExploreGitOps from "@site/docs/common/gitops.mdx"
+import ExploreGitOps from "../../common/gitops.mdx"
 
 <ExploreGitOps />
diff --git a/versioned_docs/version-2.1/aws/explore/metaphor.mdx b/versioned_docs/version-2.1/aws/explore/metaphor.mdx
index 6ff78d11..ac0967be 100644
--- a/versioned_docs/version-2.1/aws/explore/metaphor.mdx
+++ b/versioned_docs/version-2.1/aws/explore/metaphor.mdx
@@ -3,6 +3,6 @@ title: Metaphor
 sidebar_position: 3
 ---
 
-import ExploreMetaphor from "@site/docs/common/metaphor.mdx"
+import ExploreMetaphor from "../../common/metaphor.mdx"
 
 <ExploreMetaphor />
diff --git a/versioned_docs/version-2.1/aws/explore/platform.mdx b/versioned_docs/version-2.1/aws/explore/platform.mdx
index 53e73d9f..59ce88fa 100644
--- a/versioned_docs/version-2.1/aws/explore/platform.mdx
+++ b/versioned_docs/version-2.1/aws/explore/platform.mdx
@@ -3,6 +3,6 @@ title: Telemetry
 sidebar_position: 6
 ---
 
-import ExploreTelemetry from "@site/docs/common/telemetry.mdx"
+import ExploreTelemetry from "../../common/telemetry.mdx"
 
 <ExploreTelemetry />
diff --git a/versioned_docs/version-2.1/aws/explore/terraform.mdx b/versioned_docs/version-2.1/aws/explore/terraform.mdx
index e89177d9..b4030930 100644
--- a/versioned_docs/version-2.1/aws/explore/terraform.mdx
+++ b/versioned_docs/version-2.1/aws/explore/terraform.mdx
@@ -3,6 +3,6 @@ title: Terraform & Atlantis
 sidebar_position: 5
 ---
 
-import ExploreTerraform from "@site/docs/common/terraform.mdx"
+import ExploreTerraform from "../../common/terraform.mdx"
 
 <ExploreTerraform />
diff --git a/versioned_docs/version-2.1/aws/explore/user-creation.mdx b/versioned_docs/version-2.1/aws/explore/user-creation.mdx
index 42f5f2a3..89e4085b 100644
--- a/versioned_docs/version-2.1/aws/explore/user-creation.mdx
+++ b/versioned_docs/version-2.1/aws/explore/user-creation.mdx
@@ -4,10 +4,10 @@ sidebar_position: 5
 ---
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import styles from "../../stylesheets/tabs.module.css";
 
-import GitHubUserCreation from '@site/docs/civo/partials/github/_user-creation.mdx'
-import GitLabUserCreation from '@site/docs/civo/partials/gitlab/_user-creation.mdx'
+import GitHubUserCreation from '../partials/github/_user-creation.mdx'
+import GitLabUserCreation from '../partials/gitlab/_user-creation.mdx'
 
 <Tabs groupId="git_provider" defaultValue="github" queryString>
     <TabItem value="github" label="GitHub" attributes={{className: styles.github}}>
diff --git a/versioned_docs/version-2.1/aws/explore/vault.mdx b/versioned_docs/version-2.1/aws/explore/vault.mdx
index 73fefddd..a16d9e8b 100644
--- a/versioned_docs/version-2.1/aws/explore/vault.mdx
+++ b/versioned_docs/version-2.1/aws/explore/vault.mdx
@@ -3,6 +3,6 @@ title: Vault
 sidebar_position: 4
 ---
 
-import ExploreVault from "@site/docs/common/vault.mdx"
+import ExploreVault from "../../common/vault.mdx"
 
 <ExploreVault />
diff --git a/versioned_docs/version-2.1/aws/faq.mdx b/versioned_docs/version-2.1/aws/faq.mdx
index 4ea1b652..e56a407b 100644
--- a/versioned_docs/version-2.1/aws/faq.mdx
+++ b/versioned_docs/version-2.1/aws/faq.mdx
@@ -6,6 +6,6 @@ description: frequently asked quesitons about the platform
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import FAQ from "@site/docs/common/faq.mdx"
+import FAQ from "../common/faq.mdx"
 
 <FAQ />
diff --git a/versioned_docs/version-2.1/aws/overview.mdx b/versioned_docs/version-2.1/aws/overview.mdx
index f045fd1b..3436280b 100644
--- a/versioned_docs/version-2.1/aws/overview.mdx
+++ b/versioned_docs/version-2.1/aws/overview.mdx
@@ -9,11 +9,11 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import styles from "../stylesheets/tabs.module.css";
 import ReactDom from 'react-dom'
-import * as config from "@site/docs/constants.js"
-import GitHubOverview from '@site/docs/aws/partials/github/_overview.mdx'
-import GitLabOverview from '@site/docs/aws/partials/gitlab/_overview.mdx'
+import * as config from "../constants.js"
+import GitHubOverview from '../aws/partials/github/_overview.mdx'
+import GitLabOverview from '../aws/partials/gitlab/_overview.mdx'
 
 <div
   style={{
diff --git a/versioned_docs/version-2.1/aws/partials/github/_user-creation.mdx b/versioned_docs/version-2.1/aws/partials/github/_user-creation.mdx
new file mode 100644
index 00000000..926b48d4
--- /dev/null
+++ b/versioned_docs/version-2.1/aws/partials/github/_user-creation.mdx
@@ -0,0 +1,62 @@
+## Platform User Onboarding
+
+In this tutorial we will show how to add users to your platform through [Atlantis](https://www.runatlantis.io/), which will allow a preview of how changes made will be expressed through Terraform before branches are merged into your repository.
+
+Navigate to the `gitops` repository in your GitHub org, clone the contents, and create a new branch:
+
+```shell
+cd gitops
+git checkout -b new-user
+```
+
+The folder `aws-github/terraform/users/admins` contains two separate files that represent admin users: `admin-one.tf` (commented-out), and the kbot user in the `kbot.tf` file. Here's the module from `admin-one.tf`:
+
+```terraform
+module "admin_one" {
+  source = "./modules/user/github"
+
+  acl_policies            = ["admin"]
+  email                   = "your.admin@your-company.io"
+  first_name              = "Admin"
+  github_username         = "admin-one-github-username"
+  last_name               = "One"
+  team_id                 = data.github_team.admins.id
+  username                = "aone"
+  user_disabled           = false
+  userpass_accessor       = data.vault_auth_backend.userpass.accessor
+}
+```
+
+Uncomment and edit this code to replace the values for the `email`, `first_name`, `github_username`, `last_name`, and `username` before pushing to your branch.
+
+Note: If you are doing using this walkthrough simply to test Atlantis, you do not need to update these fields to be accurate.
+
+```shell
+git add .
+git commit -m feat: add new user
+git push --set-upstream origin new-user
+```
+
+Create a pull request. This will kick off the Atlantis workflow. Within a minute or so of submitting the pull request, a comment will appear on the pull request that shows the Terraform plan with the changes it will be making to your infrastructure.
+
+![Atlantis Plan Comment Example](../../../img/common/github/atlantis-comments.png)
+
+To apply these changes, you or someone in the organization can submit a comment on that pull request with the following comment text:
+
+`atlantis apply`
+
+Doing so will instruct Atlantis to apply the plan. It will report back with the results of the apply within a minute or so.
+
+NOTE: Atlantis merges your pull request automatically once an apply is successfully executed. Don't merge Terraform pull requests yourself.
+
+Atlantis will always run plans automatically for you when a pull request is opened that changes files mapped in `atlantis.yaml`.
+
+Any new users you have created through this process will have their temporary initial passwords stored in your Vault cluster. You can access Vault using the root login credentials provided to you during your kubefirst installation. Only the root Vault token can access these secrets. You will find your users' initial passwords in the Vault secret store `/secrets/users/<username>`.
+
+![vault token login](../../../img/kubefirst/local/vault-token-login.png)
+
+Once you've provided them their initial password, they can update their own password throughout the platform by updating their user password entity in Vault. Anyone can change their own password, and Admins can reset anyone's password. These rules, just like everything else on kubefirst, can be configured in your new `gitops` repository.
+
+![default user creation](../../../img/kubefirst/local/default-user-creation.png)
+
+The admins and developers that you add through IaC will automatically propagate to all tools due to the Vault OIDC provider that's preconfigured throughout the kubefirst platform tools.
diff --git a/versioned_docs/version-2.1/aws/partials/gitlab/_user-creation.mdx b/versioned_docs/version-2.1/aws/partials/gitlab/_user-creation.mdx
new file mode 100644
index 00000000..f2103425
--- /dev/null
+++ b/versioned_docs/version-2.1/aws/partials/gitlab/_user-creation.mdx
@@ -0,0 +1,63 @@
+## Platform User Onboarding
+
+In this tutorial we will show how to add users to your platform through [Atlantis](https://www.runatlantis.io/), which will allow a preview of how changes made will be expressed through Terraform before branches are merged into your repository.
+
+Navigate to the `gitops` repository in your GitLab group, clone the contents, and create a new branch:
+
+```shell
+cd gitops
+git checkout -b new-user
+```
+
+The folder `aws-gitlab/terraform/users/admins` contains two separate files that represent admin users: `admin-one.tf` (commented-out), and the kbot user in the `kbot.tf` file. Here's the module from `admin-one.tf`:
+
+```terraform
+module "admin_one" {
+  source = "../modules/user"
+
+  acl_policies            = ["admin"]
+  email                   = "your.admin@your-company.io"
+  first_name              = "Admin"
+  fullname                = "Admin One"
+  group_id                = data.vault_identity_group.admins.group_id
+  gitlab_username         = "your-admins-gitlab-username"
+  last_name               = "One"
+  username                = "aone"
+  user_disabled           = false
+  userpass_accessor       = data.vault_auth_backend.userpass.accessor
+}
+```
+
+Uncomment and edit this code to replace the values for the `email`, `first_name`, `gitlab_username`, `last_name`, and `username` before pushing to your branch.
+
+Note: If you are doing using this walkthrough simply to test Atlantis, you do not need to update these fields to be accurate.
+
+```shell
+git add .
+git commit -m feat: add new user
+git push --set-upstream origin new-user
+```
+
+Create a merge request. This will kick off the Atlantis workflow. Within a minute or so of submitting the merge request, a comment will appear on the merge request that shows the Terraform plan with the changes it will be making to your infrastructure.
+
+![Atlantis Plan Comment Example](../../../img/common/gitlab/atlantis-comments.png)
+
+To apply these changes, you or someone in the organization can submit a comment on that merge request with the following comment text:
+
+`atlantis apply`
+
+Doing so will instruct Atlantis to apply the plan. It will report back with the results of the apply within a minute or so.
+
+NOTE: Atlantis merges your merge request automatically once an apply is successfully executed. Don't merge Terraform merge requests yourself.
+
+Atlantis will always run plans automatically for you when a merge request is opened that changes files mapped in `atlantis.yaml`.
+
+Any new users you have created through this process will have their temporary initial passwords stored in your Vault cluster. You can access Vault using the root login credentials provided to you during your kubefirst installation. Only the root Vault token can access these secrets. You will find your users' initial passwords in the Vault secret store `/secrets/users/<username>`.
+
+![vault token login](../../../img/kubefirst/local/vault-token-login.png)
+
+Once you've provided them their initial password, they can update their own password throughout the platform by updating their user password entity in Vault. Anyone can change their own password, and Admins can reset anyone's password. These rules, just like everything else on kubefirst, can be configured in your new `gitops` repository.
+
+![default user creation](../../../img/kubefirst/local/default-user-creation.png)
+
+The admins and developers that you add through IaC will automatically propagate to all tools due to the Vault OIDC provider that's preconfigured throughout the kubefirst platform tools.
diff --git a/versioned_docs/version-2.1/aws/quick-start/install/cli.mdx b/versioned_docs/version-2.1/aws/quick-start/install/cli.mdx
index b750c22f..5d607d01 100644
--- a/versioned_docs/version-2.1/aws/quick-start/install/cli.mdx
+++ b/versioned_docs/version-2.1/aws/quick-start/install/cli.mdx
@@ -9,18 +9,18 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-import GitHubClusterCreateCmd from "@site/docs/aws/partials/github/_cluster-create.mdx";
-import GitLabClusterCreateCmd from "@site/docs/aws/partials/gitlab/_cluster-create.mdx";
-
-import CommonCloudPrerequisites from "@site/docs/aws/partials/common/_prerequisites.mdx";
-import CommonClusterConnectivity from "@site/docs/aws/partials/common/_cluster-connectivity.mdx";
-import CommonGitHubPrerequisites from "@site/docs/common/partials/github/_prerequisites.mdx";
-import CommonGitLabPrerequisites from "@site/docs/common/partials/gitlab/_prerequisites.mdx";
-import AWSRootCredentialsCmd from "@site/docs/aws/partials/common/_root-credentials-cmd.mdx";
-import CommonTerminalOutput from "@site/docs/common/partials/common/_terminal-output.mdx";
-
-import * as config from "@site/docs/constants.js"
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import GitHubClusterCreateCmd from "../../partials/github/_cluster-create.mdx";
+import GitLabClusterCreateCmd from "../../partials/gitlab/_cluster-create.mdx";
+
+import CommonCloudPrerequisites from "../../partials/common/_prerequisites.mdx";
+import CommonClusterConnectivity from "../../partials/common/_cluster-connectivity.mdx";
+import CommonGitHubPrerequisites from "../../../common/partials/github/_prerequisites.mdx";
+import CommonGitLabPrerequisites from "../../../common/partials/gitlab/_prerequisites.mdx";
+import AWSRootCredentialsCmd from "../../partials/common/_root-credentials-cmd.mdx";
+import CommonTerminalOutput from "../../../common/partials/common/_terminal-output.mdx";
+
+import * as config from "../../../constants.js"
+import styles from "../../../stylesheets/tabs.module.css";
 
 export const TabLabel = ({ imgSrc, label }) => (
   <div className="git-tab">
diff --git a/versioned_docs/version-2.1/aws/quick-start/repositories.mdx b/versioned_docs/version-2.1/aws/quick-start/repositories.mdx
index a8caa54d..2df2e56f 100644
--- a/versioned_docs/version-2.1/aws/quick-start/repositories.mdx
+++ b/versioned_docs/version-2.1/aws/quick-start/repositories.mdx
@@ -9,11 +9,11 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import styles from "../../stylesheets/tabs.module.css";
 import ReactDom from 'react-dom'
-import * as config from "@site/docs/constants.js"
-import GitHubRepositories from '@site/docs/aws/partials/github/_repositories.mdx'
-import GitLabRepositories from '@site/docs/aws/partials/gitlab/_repositories.mdx'
+import * as config from "../../constants.js"
+import GitHubRepositories from '../partials/github/_repositories.mdx'
+import GitLabRepositories from '../partials/gitlab/_repositories.mdx'
 
 <div
   style={{
diff --git a/versioned_docs/version-2.1/civo/credits.mdx b/versioned_docs/version-2.1/civo/credits.mdx
index 11475ce6..12d481c3 100644
--- a/versioned_docs/version-2.1/civo/credits.mdx
+++ b/versioned_docs/version-2.1/civo/credits.mdx
@@ -6,6 +6,6 @@ description: credit to all the awesome open source projects
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import CommonCredits from "@site/docs/common/credits.mdx"
+import CommonCredits from "../common/credits.mdx"
 
 <CommonCredits />
diff --git a/versioned_docs/version-2.1/civo/deprovision.mdx b/versioned_docs/version-2.1/civo/deprovision.mdx
index e8496975..40207c49 100644
--- a/versioned_docs/version-2.1/civo/deprovision.mdx
+++ b/versioned_docs/version-2.1/civo/deprovision.mdx
@@ -9,6 +9,6 @@ keywords:
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import Deprovision from '@site/docs/common/deprovision.mdx'
+import Deprovision from '../common/deprovision.mdx'
 
 <Deprovision />
diff --git a/versioned_docs/version-2.1/civo/explore/argocd.mdx b/versioned_docs/version-2.1/civo/explore/argocd.mdx
index 9f4f59f0..9a09befa 100644
--- a/versioned_docs/version-2.1/civo/explore/argocd.mdx
+++ b/versioned_docs/version-2.1/civo/explore/argocd.mdx
@@ -3,6 +3,6 @@ title: Argo CD
 sidebar_position: 1
 ---
 
-import ExploreArgocd from "@site/docs/common/argocd.mdx"
+import ExploreArgocd from "../../common/argocd.mdx"
 
 <ExploreArgocd />
diff --git a/versioned_docs/version-2.1/civo/explore/gitops.mdx b/versioned_docs/version-2.1/civo/explore/gitops.mdx
index b1ac43cd..cfa55bbc 100644
--- a/versioned_docs/version-2.1/civo/explore/gitops.mdx
+++ b/versioned_docs/version-2.1/civo/explore/gitops.mdx
@@ -4,6 +4,6 @@ sidebar_position: 2
 ---
 
 
-import ExploreGitOps from "@site/docs/common/gitops.mdx"
+import ExploreGitOps from "../../common/gitops.mdx"
 
 <ExploreGitOps />
diff --git a/versioned_docs/version-2.1/civo/explore/metaphor.mdx b/versioned_docs/version-2.1/civo/explore/metaphor.mdx
index 6ff78d11..ac0967be 100644
--- a/versioned_docs/version-2.1/civo/explore/metaphor.mdx
+++ b/versioned_docs/version-2.1/civo/explore/metaphor.mdx
@@ -3,6 +3,6 @@ title: Metaphor
 sidebar_position: 3
 ---
 
-import ExploreMetaphor from "@site/docs/common/metaphor.mdx"
+import ExploreMetaphor from "../../common/metaphor.mdx"
 
 <ExploreMetaphor />
diff --git a/versioned_docs/version-2.1/civo/explore/telemetry.mdx b/versioned_docs/version-2.1/civo/explore/telemetry.mdx
index dfebeac8..41311723 100644
--- a/versioned_docs/version-2.1/civo/explore/telemetry.mdx
+++ b/versioned_docs/version-2.1/civo/explore/telemetry.mdx
@@ -3,6 +3,6 @@ title: Telemetry
 sidebar_position: 7
 ---
 
-import ExploreTelemetry from "@site/docs/common/telemetry.mdx"
+import ExploreTelemetry from "../../common/telemetry.mdx"
 
 <ExploreTelemetry />
diff --git a/versioned_docs/version-2.1/civo/explore/terraform.mdx b/versioned_docs/version-2.1/civo/explore/terraform.mdx
index cfdd1f88..9e4c817d 100644
--- a/versioned_docs/version-2.1/civo/explore/terraform.mdx
+++ b/versioned_docs/version-2.1/civo/explore/terraform.mdx
@@ -3,6 +3,6 @@ title: Terraform & Atlantis
 sidebar_position: 4
 ---
 
-import ExploreTerraform from "@site/docs/common/terraform.mdx"
+import ExploreTerraform from "../../common/terraform.mdx"
 
 <ExploreTerraform />
diff --git a/versioned_docs/version-2.1/civo/explore/user-creation.mdx b/versioned_docs/version-2.1/civo/explore/user-creation.mdx
index 75221db8..c798c341 100644
--- a/versioned_docs/version-2.1/civo/explore/user-creation.mdx
+++ b/versioned_docs/version-2.1/civo/explore/user-creation.mdx
@@ -5,10 +5,10 @@ sidebar_position: 5
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import styles from "../../stylesheets/tabs.module.css";
 
-import GitHubUserCreation from '@site/docs/civo/partials/github/_user-creation.mdx'
-import GitLabUserCreation from '@site/docs/civo/partials/gitlab/_user-creation.mdx'
+import GitHubUserCreation from '../partials/github/_user-creation.mdx'
+import GitLabUserCreation from '../partials/gitlab/_user-creation.mdx'
 
 <Tabs groupId="git_provider" defaultValue="github" queryString>
     <TabItem
diff --git a/versioned_docs/version-2.1/civo/explore/vault.mdx b/versioned_docs/version-2.1/civo/explore/vault.mdx
index 49695f4a..78f63959 100644
--- a/versioned_docs/version-2.1/civo/explore/vault.mdx
+++ b/versioned_docs/version-2.1/civo/explore/vault.mdx
@@ -3,6 +3,6 @@ title: Vault
 sidebar_position: 6
 ---
 
-import ExploreVault from "@site/docs/common/vault.mdx"
+import ExploreVault from "../../common/vault.mdx"
 
 <ExploreVault />
diff --git a/versioned_docs/version-2.1/civo/faq.mdx b/versioned_docs/version-2.1/civo/faq.mdx
index 55bb58eb..ab241f41 100644
--- a/versioned_docs/version-2.1/civo/faq.mdx
+++ b/versioned_docs/version-2.1/civo/faq.mdx
@@ -6,6 +6,6 @@ description: frequently asked quesitons about the kubefirst platform
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import FAQ from "@site/docs/common/faq.mdx"
+import FAQ from "../common/faq.mdx"
 
 <FAQ />
diff --git a/versioned_docs/version-2.1/civo/overview.mdx b/versioned_docs/version-2.1/civo/overview.mdx
index b7514d5e..8fd892d7 100644
--- a/versioned_docs/version-2.1/civo/overview.mdx
+++ b/versioned_docs/version-2.1/civo/overview.mdx
@@ -9,12 +9,12 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import styles from "../stylesheets/tabs.module.css";
 import ReactDom from 'react-dom'
-import * as config from "@site/docs/constants.js"
+import * as config from "../constants.js"
 
-import GitHubOverview from '@site/docs/civo/partials/github/_overview.mdx'
-import GitLabOverview from '@site/docs/civo/partials/gitlab/_overview.mdx'
+import GitHubOverview from '../civo/partials/github/_overview.mdx'
+import GitLabOverview from '../civo/partials/gitlab/_overview.mdx'
 import CloudBanner from '@site/src/components/CloudBanner/CloudBanner.jsx'
 
 <div
diff --git a/versioned_docs/version-2.1/civo/platform.mdx b/versioned_docs/version-2.1/civo/platform.mdx
index 67c8d66a..aeda90f6 100644
--- a/versioned_docs/version-2.1/civo/platform.mdx
+++ b/versioned_docs/version-2.1/civo/platform.mdx
@@ -6,6 +6,6 @@ description: an overview of kubefirst
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import Platform from "@site/docs/common/platform.mdx"
+import Platform from "../common/platform.mdx"
 
 <Platform />
diff --git a/versioned_docs/version-2.1/civo/quick-start/install/cli.mdx b/versioned_docs/version-2.1/civo/quick-start/install/cli.mdx
index 5a8fe685..be0b5947 100644
--- a/versioned_docs/version-2.1/civo/quick-start/install/cli.mdx
+++ b/versioned_docs/version-2.1/civo/quick-start/install/cli.mdx
@@ -9,18 +9,18 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-import GitHubPrerequisites from "@site/docs/common/partials/github/_prerequisites.mdx";
-import GitHubClusterCreateCmd from "@site/docs/civo/partials/github/_cluster-create.mdx";
+import GitHubPrerequisites from "../../../common/partials/github/_prerequisites.mdx";
+import GitHubClusterCreateCmd from "../../partials/github/_cluster-create.mdx";
 
-import GitLabPrerequisites from "@site/docs/common/partials/gitlab/_prerequisites.mdx";
-import GitLabClusterCreateCmd from "@site/docs/civo/partials/gitlab/_cluster-create.mdx";
+import GitLabPrerequisites from "../../../common/partials/gitlab/_prerequisites.mdx";
+import GitLabClusterCreateCmd from "../../partials/gitlab/_cluster-create.mdx";
 
-import CommonCloudPrerequisites from "@site/docs/civo/partials/common/_prerequisites.mdx";
-import CommonClusterConnectivity from "@site/docs/civo/partials/common/_cluster-connectivity.mdx";
-import CommonRootCredentialsCmd from "@site/docs/civo/partials/common/_root-credentials-cmd.mdx";
+import CommonCloudPrerequisites from "../../partials/common/_prerequisites.mdx";
+import CommonClusterConnectivity from "../../partials/common/_cluster-connectivity.mdx";
+import CommonRootCredentialsCmd from "../../partials/common/_root-credentials-cmd.mdx";
 
-import * as config from "@site/docs/constants.js"
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import * as config from "../../../constants.js"
+import styles from "../../../stylesheets/tabs.module.css";
 
 export const TabLabel = ({ imgSrc, label }) => (
   <div className="git-tab">
diff --git a/versioned_docs/version-2.1/civo/quick-start/repositories.mdx b/versioned_docs/version-2.1/civo/quick-start/repositories.mdx
index 185000f7..a5a11c6c 100644
--- a/versioned_docs/version-2.1/civo/quick-start/repositories.mdx
+++ b/versioned_docs/version-2.1/civo/quick-start/repositories.mdx
@@ -9,11 +9,10 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
-import ReactDom from 'react-dom'
-import * as config from "@site/docs/constants.js"
-import GitHubRepositories from '@site/docs/civo/partials/github/_repositories.mdx'
-import GitLabRepositories from '@site/docs/civo/partials/gitlab/_repositories.mdx'
+import styles from "../../stylesheets/tabs.module.css";
+import * as config from "../../constants.js"
+import GitHubRepositories from '../partials/github/_repositories.mdx'
+import GitLabRepositories from '../partials/gitlab/_repositories.mdx'
 
 <div
   style={{
diff --git a/versioned_docs/version-2.1/common/git-auth.mdx b/versioned_docs/version-2.1/common/git-auth.mdx
index 9f02b861..98f1e81f 100644
--- a/versioned_docs/version-2.1/common/git-auth.mdx
+++ b/versioned_docs/version-2.1/common/git-auth.mdx
@@ -5,12 +5,12 @@ id: gitAuth
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import styles from "../stylesheets/tabs.module.css";
 
-import GitHubTokens from '@site/docs/common/partials/github/_tokens.mdx'
-import GitLabTokens from '@site/docs/common/partials/gitlab/_tokens.mdx'
+import GitHubTokens from '../common/partials/github/_tokens.mdx'
+import GitLabTokens from '../common/partials/gitlab/_tokens.mdx'
 
-import * as config from "@site/docs/constants.js"
+import * as config from "../constants.js"
 
 <div
   style={{
diff --git a/versioned_docs/version-2.1/k3d/credits.mdx b/versioned_docs/version-2.1/k3d/credits.mdx
index 64a8c058..fc9c06fc 100644
--- a/versioned_docs/version-2.1/k3d/credits.mdx
+++ b/versioned_docs/version-2.1/k3d/credits.mdx
@@ -7,6 +7,6 @@ description: Credits for the awesome open source we use
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import Credits from "@site/docs/common/credits.mdx"
+import Credits from "../common/credits.mdx"
 
 <Credits />
diff --git a/versioned_docs/version-2.1/k3d/deprovision.mdx b/versioned_docs/version-2.1/k3d/deprovision.mdx
index 83694cae..a2e61c52 100644
--- a/versioned_docs/version-2.1/k3d/deprovision.mdx
+++ b/versioned_docs/version-2.1/k3d/deprovision.mdx
@@ -7,6 +7,6 @@ description: how to deprovision your kubefirst platform
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import Deprovision from '@site/docs/common/deprovision.mdx'
+import Deprovision from '../common/deprovision.mdx'
 
 <Deprovision />
diff --git a/versioned_docs/version-2.1/k3d/explore/argocd.mdx b/versioned_docs/version-2.1/k3d/explore/argocd.mdx
index 6d707b52..da675e60 100644
--- a/versioned_docs/version-2.1/k3d/explore/argocd.mdx
+++ b/versioned_docs/version-2.1/k3d/explore/argocd.mdx
@@ -3,6 +3,6 @@ title: Argo CD
 sidebar_position: 2
 ---
 
-import ExploreArgocd from "@site/docs/common/argocd.mdx"
+import ExploreArgocd from "../../common/argocd.mdx"
 
 <ExploreArgocd />
diff --git a/versioned_docs/version-2.1/k3d/explore/gitops.mdx b/versioned_docs/version-2.1/k3d/explore/gitops.mdx
index 9811501f..4095967b 100644
--- a/versioned_docs/version-2.1/k3d/explore/gitops.mdx
+++ b/versioned_docs/version-2.1/k3d/explore/gitops.mdx
@@ -4,6 +4,6 @@ sidebar_position: 3
 ---
 
 
-import ExploreGitOps from "@site/docs/common/gitops.mdx"
+import ExploreGitOps from "../../common/gitops.mdx"
 
 <ExploreGitOps />
diff --git a/versioned_docs/version-2.1/k3d/explore/metaphor.mdx b/versioned_docs/version-2.1/k3d/explore/metaphor.mdx
index 55866031..504b2189 100644
--- a/versioned_docs/version-2.1/k3d/explore/metaphor.mdx
+++ b/versioned_docs/version-2.1/k3d/explore/metaphor.mdx
@@ -3,6 +3,6 @@ title: Metaphor
 sidebar_position: 4
 ---
 
-import ExploreMetaphor from "@site/docs/common/metaphor.mdx"
+import ExploreMetaphor from "../../common/metaphor.mdx"
 
 <ExploreMetaphor />
diff --git a/versioned_docs/version-2.1/k3d/explore/telemetry.mdx b/versioned_docs/version-2.1/k3d/explore/telemetry.mdx
index 07395e53..c2b51822 100644
--- a/versioned_docs/version-2.1/k3d/explore/telemetry.mdx
+++ b/versioned_docs/version-2.1/k3d/explore/telemetry.mdx
@@ -3,6 +3,6 @@ title: Telemetry
 sidebar_position: 8
 ---
 
-import ExploreTelemetry from "@site/docs/common/telemetry.mdx"
+import ExploreTelemetry from "../../common/telemetry.mdx"
 
 <ExploreTelemetry />
diff --git a/versioned_docs/version-2.1/k3d/explore/terraform.mdx b/versioned_docs/version-2.1/k3d/explore/terraform.mdx
index e89177d9..b4030930 100644
--- a/versioned_docs/version-2.1/k3d/explore/terraform.mdx
+++ b/versioned_docs/version-2.1/k3d/explore/terraform.mdx
@@ -3,6 +3,6 @@ title: Terraform & Atlantis
 sidebar_position: 5
 ---
 
-import ExploreTerraform from "@site/docs/common/terraform.mdx"
+import ExploreTerraform from "../../common/terraform.mdx"
 
 <ExploreTerraform />
diff --git a/versioned_docs/version-2.1/k3d/explore/user-creation.mdx b/versioned_docs/version-2.1/k3d/explore/user-creation.mdx
index c2be6186..445c74ec 100644
--- a/versioned_docs/version-2.1/k3d/explore/user-creation.mdx
+++ b/versioned_docs/version-2.1/k3d/explore/user-creation.mdx
@@ -5,10 +5,10 @@ sidebar_position: 6
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import styles from "../../stylesheets/tabs.module.css";
 
-import GitHubUserCreation from '@site/docs/civo/partials/github/_user-creation.mdx'
-import GitLabUserCreation from '@site/docs/civo/partials/gitlab/_user-creation.mdx'
+import GitHubUserCreation from '../partials/github/_user-creation.mdx'
+import GitLabUserCreation from '../partials/gitlab/_user-creation.mdx'
 
 <Tabs groupId="git_provider" defaultValue="github" queryString>
     <TabItem value="github" label="GitHub" attributes={{className: styles.github}}>
diff --git a/versioned_docs/version-2.1/k3d/explore/vault.mdx b/versioned_docs/version-2.1/k3d/explore/vault.mdx
index adb0126a..15c175fd 100644
--- a/versioned_docs/version-2.1/k3d/explore/vault.mdx
+++ b/versioned_docs/version-2.1/k3d/explore/vault.mdx
@@ -3,6 +3,6 @@ title: Vault
 sidebar_position: 7
 ---
 
-import ExploreVault from "@site/docs/common/vault.mdx"
+import ExploreVault from "../../common/vault.mdx"
 
 <ExploreVault />
diff --git a/versioned_docs/version-2.1/k3d/faq.mdx b/versioned_docs/version-2.1/k3d/faq.mdx
index be3487f7..11c86d80 100644
--- a/versioned_docs/version-2.1/k3d/faq.mdx
+++ b/versioned_docs/version-2.1/k3d/faq.mdx
@@ -7,6 +7,6 @@ description: frequently asked quesitons about the kubefirst platform
 image: "https://docs.kubefirst.io/img/logo.svg"
 ---
 
-import FAQ from "@site/docs/common/faq.mdx"
+import FAQ from "../common/faq.mdx"
 
 <FAQ />
diff --git a/versioned_docs/version-2.1/k3d/overview.mdx b/versioned_docs/version-2.1/k3d/overview.mdx
index 253f7c32..02da36b3 100644
--- a/versioned_docs/version-2.1/k3d/overview.mdx
+++ b/versioned_docs/version-2.1/k3d/overview.mdx
@@ -9,11 +9,11 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
+import styles from "../stylesheets/tabs.module.css";
 import ReactDom from 'react-dom'
-import * as config from "@site/docs/constants.js"
-import GitHubOverview from '@site/docs/k3d/partials/github/_overview.mdx'
-import GitLabOverview from '@site/docs/k3d/partials/gitlab/_overview.mdx'
+import * as config from "../constants.js"
+import GitHubOverview from '../k3d/partials/github/_overview.mdx'
+import GitLabOverview from '../k3d/partials/gitlab/_overview.mdx'
 
 <div
   style={{
diff --git a/versioned_docs/version-2.1/k3d/quick-start/install.mdx b/versioned_docs/version-2.1/k3d/quick-start/install.mdx
index 667eb993..f413f4bc 100644
--- a/versioned_docs/version-2.1/k3d/quick-start/install.mdx
+++ b/versioned_docs/version-2.1/k3d/quick-start/install.mdx
@@ -8,9 +8,10 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
-import ReactDom from 'react-dom'
-import * as config from "@site/docs/constants.js"
+import styles from "../../stylesheets/tabs.module.css";
+import * as config from "../../constants.js"
+import GitHubInstall from '../partials/github/_install.mdx'
+import GitLabInstall from '../partials/gitlab/_install.mdx'
 
 <div
   style={{
@@ -24,9 +25,6 @@ import * as config from "@site/docs/constants.js"
   </div>
 </div>
 
-import GitHubInstall from '@site/docs/k3d/partials/github/_install.mdx'
-import GitLabInstall from '@site/docs/k3d/partials/gitlab/_install.mdx'
-
 <Tabs groupId="git_provider" defaultValue="github" queryString>
     <TabItem
       attributes={{className: styles.github}}
diff --git a/versioned_docs/version-2.1/k3d/quick-start/repositories.mdx b/versioned_docs/version-2.1/k3d/quick-start/repositories.mdx
index 983156e6..bb492fd2 100644
--- a/versioned_docs/version-2.1/k3d/quick-start/repositories.mdx
+++ b/versioned_docs/version-2.1/k3d/quick-start/repositories.mdx
@@ -8,9 +8,10 @@ image: "https://docs.kubefirst.io/img/logo.svg"
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
-import styles from "@site/docs/stylesheets/tabs.module.css";
-import ReactDom from 'react-dom'
-import * as config from "@site/docs/constants.js"
+import styles from "../../stylesheets/tabs.module.css";
+import * as config from "../../constants.js"
+import GitHubRepositories from '../partials/github/_repositories.mdx'
+import GitLabRepositories from '../partials/gitlab/_repositories.mdx'
 
 <div
   style={{
@@ -24,9 +25,6 @@ import * as config from "@site/docs/constants.js"
   </div>
 </div>
 
-import GitHubRepositories from '@site/docs/k3d/partials/github/_repositories.mdx'
-import GitLabRepositories from '@site/docs/k3d/partials/gitlab/_repositories.mdx'
-
 <Tabs groupId="git_provider" defaultValue="github" queryString>
     <TabItem
       attributes={{className: styles.github}}