From 555b43095d365963544efc0262ed7b03af78ac8c Mon Sep 17 00:00:00 2001 From: Julien Huang <63512348+huang-julien@users.noreply.github.com> Date: Mon, 26 Sep 2022 11:24:03 +0200 Subject: [PATCH] docs(guide): add nitro plugins to server directory (#7780) --- .../2.guide/2.directory-structure/1.server.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/content/2.guide/2.directory-structure/1.server.md b/docs/content/2.guide/2.directory-structure/1.server.md index ff942672fb7..5bf170d59c0 100644 --- a/docs/content/2.guide/2.directory-structure/1.server.md +++ b/docs/content/2.guide/2.directory-structure/1.server.md @@ -66,6 +66,21 @@ export default defineEventHandler((event) => { }) ``` +## Server Plugins + +Nuxt will automatically read any files in the `~/server/plugins` directory and register them as Nitro plugins. This allows extending Nitro's runtime behavior and hooking into lifecycle events. + +**Example:** + +```ts [server/plugins/nitroPlugin.ts] +export default defineNitroPlugin((nitroApp) => { + console.log('Nitro plugin', nitroApp) +}) +``` + +::ReadMore{link="https://nitro.unjs.io/guide/advanced/plugins" title="Nitro Plugins"} +:: + ## Server Utilities Server routes are powered by [unjs/h3](https://github.com/unjs/h3) which comes with a handy set of helpers.