docs: Add seed configuration for database population with Nitro Tasks (#107)

Co-authored-by: Sébastien Chopin <[email protected]>

Author: onmax

docs/content/docs/4.recipes/2.drizzle.md

@@ -154,6 +154,59 @@ Note that we are also exporting the `User` type, which is inferred from the `use
 We also export the `sql`, `eq`, `and`, and `or` functions from `drizzle-orm` to be used in our queries.
 ::
 
+### Seed the database (Optional)
+
+::collapsible{name="instructions"}
+
+Optionally, you can add a server task to populate your database with initial data. This uses [Nitro Tasks](https://nitro.unjs.io/guide/tasks), which is currently an experimental feature.
+
+1. Update your nuxt.config.js:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  nitro: {
+    experimental: {
+      tasks: true
+    }
+  }
+})
+```
+
+2. Create a new file containing the task:
+
+```ts [server/task/seed.ts]
+export default defineTask({
+  meta: {
+    name: "db:seed",
+    description: "Run database seed task",
+  },
+  async run() {
+    console.log("Running DB seed task...")
+    const seed = [
+      {
+        name: "John Doe",
+        email: "[email protected]",
+        password: "password123",
+        avatar: "https://example.com/avatar/john.png",
+        createdAt: Date.now(),
+      },
+      {
+        name: "Jane Doe",
+        email: "[email protected]",
+        password: "password123",
+        avatar: "https://example.com/avatar/jane.png",
+        createdAt: Date.now(),
+      },
+    ]
+    await useDrizzle().insert(tables.users).values(users);
+    return { result: "success" }
+  }
+})
+```
+
+To run the seed task, start your dev server and open the Nuxt Devtools. Go to _Tasks_ and you will see the `db:seed` task ready to run. This will add the seed data to your database and give you the first users to work with.
+
+::
 
 ## Usage