docs: add cloudflare hyperdrive docs

docs/content/docs/2.database/1.index.md

@@ -439,6 +439,33 @@ Configure replicas in your `nuxt.config.ts`:
   :::
 ::
 
+### Cloudflare Hyperdrive
+
+When using Cloudflare Hyperdrive, you first have to set up Hyperdrive in Cloudflare and set the generated ID in `nuxt.config.ts`:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  hub: {
+    db: {
+      dialect: 'postgresql',
+      connection: {
+        hyperdriveId: '<your-hyperdrive-id>',
+      },
+    },
+  },
+})
+```
+
+With this, NuxtHub will apply migrations on build to the configured database connection.
+
+::tip
+Use direct database connection string instead of pooling when configuring Hyperdrive.
+::
+
+::warning
+We've [open issue](https://github.com/nuxt-hub/core/issues/869) regarding migrations don't apply when `db.connection.hyperdriveId` is set, so for now (v0.10.8+) you have to also pass direct database connection string with `DATABASE_URL`, `POSTGRES_URL` or relevant environment variable when building the application to ensure migrations are applied.
+::
+
 ## AI Agents
 
 If you work with an IDE that supports AI agents, you can add the following text in your `Agents.md` or `.cursor/rules` file: