From 5093e2c585733922527349e67efa4a2c828bf341 Mon Sep 17 00:00:00 2001
From: Howard Guo <50100922+toto6038@users.noreply.github.com>
Date: Thu, 24 Jul 2025 05:14:51 +0800
Subject: [PATCH] docs: Nuxt module README (#3013)

Co-authored-by: Eduardo San Martin Morote <posva@users.noreply.github.com>
---
 packages/nuxt/README.md     | 49 ++++++++++++++++++++++++++++---------
 packages/nuxt/src/module.ts |  1 +
 2 files changed, 39 insertions(+), 11 deletions(-)

diff --git a/packages/nuxt/README.md b/packages/nuxt/README.md
index 66f7cba8..cac35328 100644
--- a/packages/nuxt/README.md
+++ b/packages/nuxt/README.md
@@ -1,29 +1,56 @@
 # `@pinia/nuxt`
 
-> Nuxt 2 & 3 module
+> Nuxt module for Pinia
 
-## Installation
+## Automatic Installation
+
+Use `nuxi` to automatically add this module to your Nuxt project:
 
 ```shell
-npm i pinia @pinia/nuxt
+npx nuxi@latest module add pinia
 ```
 
-## Usage
+## Manual Installation
+
+Add dependencies to your Nuxt project:
+
+```shell
+npm i pinia @pinia/nuxt
+```
 
-Add to `modules` (Nuxt 3) or `buildModules` (Nuxt 2) in `nuxt.config.js`:
+Enable the `@pinia/nuxt` module in `nuxt.config.ts`:
 
 ```js
-// Nuxt 2
-export default {
-  buildModules: [['@pinia/nuxt', { disableVuex: true }]],
-}
-// Nuxt 3
 export default defineNuxtConfig({
     modules: ['@pinia/nuxt'],
 })
 ```
 
-Note you also need `@nuxtjs/composition-api` if you are using Nuxt 2 without Bridge. [Refer to docs for more](https://pinia.vuejs.org/ssr/nuxt.html).
+## Configuring the Module
+
+By default, this module adds `stores` folder to auto imports, in which you can organize code related to Pinia stores in one place.
+> [!TIP]
+> In the new directory structure introduced since Nuxt 4, this directory is `app/stores`.
+
+You can customize this behaviour using the `pinia` property in `nuxt.config.ts`:
+
+```js
+export default defineNuxtConfig({
+    modules: ['@pinia/nuxt'],
+    // configure the module using `pinia` property
+    pinia: {
+      /**
+       * Automatically add stores dirs to the auto imports. This is the same as
+       * directly adding the dirs to the `imports.dirs` option. If you want to
+       * also import nested stores, you can use the glob pattern `./stores/**`
+       * (on Nuxt 3) or `app/stores/**` (on Nuxt 4+)
+       *
+       * @default `['stores']`
+       */
+        storesDirs: []
+    }
+})
+```
 
 ## License
 
diff --git a/packages/nuxt/src/module.ts b/packages/nuxt/src/module.ts
index afa369cc..7542ccec 100644
--- a/packages/nuxt/src/module.ts
+++ b/packages/nuxt/src/module.ts
@@ -16,6 +16,7 @@ export interface ModuleOptions {
    * Automatically add stores dirs to the auto imports. This is the same as
    * directly adding the dirs to the `imports.dirs` option. If you want to
    * also import nested stores, you can use the glob pattern `./stores/**`
+   * (on Nuxt 3) or `app/stores/**` (on Nuxt 4+)
    *
    * @default `['stores']`
    */
-- 
2.47.2