diff --git a/docs/2.guide/2.directory-structure/1.shared.md b/docs/2.guide/2.directory-structure/1.shared.md
new file mode 100644
index 0000000000..72fabd5f1e
--- /dev/null
+++ b/docs/2.guide/2.directory-structure/1.shared.md
@@ -0,0 +1,77 @@
+---
+title: 'shared'
+head.title: 'shared/'
+description: Use the shared/ directory to share functionality between the Vue app and the Nitro server.
+navigation.icon: i-ph-folder
+---
+
+The `shared/` directory allows you to share code that can be used in both the Vue app and the Nitro server.
+
+::tip
+The `shared/` directory is available in Nuxt v3.14+.
+::
+
+::important
+Code in the shared directory cannot import any Vue or nitro code.
+::
+
+## Usage
+
+**Method 1:** Using named export
+
+```ts twoslash [shared/utils/capitalize.ts]
+export const capitalize = (input: string) => {
+ return input[0].toUpperCase() + input.slice(1)
+}
+```
+
+**Method 2:** Using default export
+
+```ts twoslash [shared/utils/capitalize.ts]
+export default function capitalize (input: string) {
+ return input[0].toUpperCase() + input.slice(1)
+}
+```
+
+**Usage:** You can now use auto-imported utility functions in `.js`, `.ts` and `.vue` files within your Vue app and the `server/` directory.
+
+If you are using `compatibilityVersion: 4`, you can use the auto-imported functions in the `app/` directory.
+
+```vue [app.vue]
+
+
+
+
+ {{ hello }}
+
+
+```
+
+```ts [server/api/hello.get.ts]
+export default defineEventHandler((event) => {
+ return {
+ hello: capitalize('hello')
+ }
+})
+```
+
+## Auto Imports
+
+Only files in the `shared/utils/` and `shared/types/` directories will be auto-imported.
+
+```bash [Directory Structure]
+-| shared/
+---| foo.ts # Not auto-imported
+---| utils/
+-----| bar.ts # Auto-imported
+---| types/
+-----| bar.d.ts # Auto-imported
+```
+
+Any other files you create in the shared folder must be manually imported using `import foo from '#shared/foo'`.
+
+This includes nested directories. A file located at `shared/formatters/lower.ts` will be imported with `import lower from '#shared/formatters/lower'`.
+
+:read-more{to="/docs/guide/concepts/auto-imports"}