diff --git a/arkanum b/arkanum
index 1ca8079..f7606e7 100755
--- a/arkanum
+++ b/arkanum
@@ -227,7 +227,7 @@ function instCodeExtension() {
 
 function setCodeSettings() {
   CODEFILE="$HOME/data/User/settings.json"
-
+  #region code-settings
   # VSCode user settings file
   say "Setting VScode base settings.($CODEFILE)" "VSCode"
   cat <<EOF | tee "$CODEFILE"
@@ -244,6 +244,7 @@ function setCodeSettings() {
   "telemetry.telemetryLevel": "off"
 }
 EOF
+  #endregion code-settings
   say "done." "VSCode"
 }
 
diff --git a/docs/.vitepress/sidebar.mjs b/docs/.vitepress/sidebar.mjs
index 6ead234..f5028d2 100644
--- a/docs/.vitepress/sidebar.mjs
+++ b/docs/.vitepress/sidebar.mjs
@@ -19,6 +19,7 @@ function getGuide() {
             { text: 'Git', link: 'components/git' },
             { text: 'Arkanum CLI', link: 'components/arkanum-cli' },
             { text: 'FiraCode Font', link: 'components/firacode' },
+            { text: 'VSCode', link: 'components/vscode' },
           ],
         },
       ],
diff --git a/docs/guide/components/starship.md b/docs/guide/components/starship.md
index 60f5f77..a16e06d 100644
--- a/docs/guide/components/starship.md
+++ b/docs/guide/components/starship.md
@@ -20,7 +20,6 @@ The included default setup uses the system wide installed [NerdFont](https://www
 
 ![screen5](./prompts/prompt5.png 'git rep with golang project and open workspace changes')
 
-
 ## Configuration
 
 ::: code-group
diff --git a/docs/guide/components/vscode.md b/docs/guide/components/vscode.md
new file mode 100644
index 0000000..78713a2
--- /dev/null
+++ b/docs/guide/components/vscode.md
@@ -0,0 +1,43 @@
+# VSCode
+
+## Default Settings
+
+Arkanum tests for existing VSCode user config. If not preset, it sets the default config with these values:
+
+|               Key                | Value                                                                                   | Description                                                                                              |
+| :------------------------------: | :-------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+|    `window.menuBarVisibility`    | **compact**                                                                             | Uses compact main menu bar in hamburger style.                                                           |
+|      `workbench.colorTheme`      | **One Dark Pro Darker**                                                                 | Enables default color theme.                                                                             |
+|      `workbench.iconTheme`       | **vscode-icons**                                                                        | Enables default icon theme for file tree.                                                                |
+|       `editor.fontFamily`        | **'FiraCode', 'FiraCode Nerd Font', 'FiraCode NF', Consolas, 'Courier New', monospace** | Enables included FiraCode font for all possible variations in the file editor.                           |
+| `terminal.integrated.fontFamily` | **'FiraCode Mono', 'FiraCode Nerd Font Mono', 'FiraCode NFM', Consolas, monospace**     | Enables included FiraCode fonts in terminal views. Uses mono variation to enable showing icons.          |
+|      `editor.fontLigatures`      | **true**                                                                                | Enables font ligatures supported in FiraCode: `->`, `---`, `!=` ...                                      |
+|      `editor.formatOnSave`       | **true**                                                                                | Enables format on save features based on language config.                                                |
+|     `extensions.autoUpdate`      | **false**                                                                               | Disables automatic update for installed extensions. Prevents running into VSCode compatibility problems. |
+|        `git.confirmSync`         | **false**                                                                               | Disables notification popup for git sync action.                                                         |
+|    `telemetry.telemetryLevel`    | **off**                                                                                 | Disables sending telemetry data for VSCode and GitLense Extension.                                       |
+
+## Extensions
+
+Arkanum includes the following VSCode extensions from the Open VSX Registry:
+
+### GitLense
+
+Adds advanced git features with the [GitLense](https://open-vsx.org/extension/eamodio/gitlens) extension.
+
+### One Dark Pro
+
+Adds [One Dark Pro](https://open-vsx.org/extension/zhuangtongfa/material-theme) theme as default color theme.
+
+### vscode-icons
+
+Adds [vscode-icons](https://open-vsx.org/extension/vscode-icons-team/vscode-icons) extension as default icon theme.
+
+## Configuration
+
+::: code-group
+
+<<< @/../Dockerfile#cli{Dockerfile}
+
+<<< @/../arkanum#code-settings{4-15 bash:line-numbers}
+:::