diff --git a/.nuxtrc b/.nuxtrc
index f610600..59f96be 100644
--- a/.nuxtrc
+++ b/.nuxtrc
@@ -1,2 +1,2 @@
-setups.nuxt-convex="0.0.1"
+setups.nuxt-convex="0.0.6"
 setups.@nuxt/test-utils="3.23.0"
\ No newline at end of file
diff --git a/docs/content/5.integrations/1.better-auth.md b/docs/content/5.integrations/1.better-auth.md
index d74f17d..c8e2455 100644
--- a/docs/content/5.integrations/1.better-auth.md
+++ b/docs/content/5.integrations/1.better-auth.md
@@ -3,40 +3,50 @@ title: Better Auth
 description: Use Convex as the database for Better Auth authentication.
 ---
 
-# Better Auth Integration
+Use Convex as the database backend for [Better Auth](https://better-auth.com) with `@onmax/nuxt-better-auth`.
 
-Use Convex as the database backend for [Better Auth](https://better-auth.com) with the [`@onmax/nuxt-better-auth`](https://github.com/onmax/nuxt-better-auth) module.
+`nuxt-convex` registers the `convex` database provider via the `better-auth:database:providers` hook. `@onmax/nuxt-better-auth` then generates `#auth/database` from that provider.
 
-## How It Works
+::important
+This integration runs on the server. `auth.database.provider = 'convex'` is not available in `clientOnly` mode.
+::
 
-- Auth runs on **Nuxt server** (SSR-compatible, route protection)
-- Convex provides the **database** via HTTP adapter
-- Uses `@convex-dev/better-auth` CRUD functions
+::steps
 
-## Setup
-
-### 1. Install Dependencies
+### Install dependencies
 
 ```bash
 pnpm add @onmax/nuxt-better-auth @convex-dev/better-auth better-auth
 ```
 
-### 2. Configure Nuxt
+### Configure Nuxt
 
 ```ts [nuxt.config.ts]
 export default defineNuxtConfig({
   modules: ['nuxt-convex', '@onmax/nuxt-better-auth'],
+  auth: {
+    database: {
+      provider: 'convex',
+      // Optional override (highest priority).
+      // convexUrl: 'https://your-project.convex.cloud',
+    },
+  },
 })
 ```
 
-### 3. Set Environment Variables
+### Set environment variables
 
 ```bash [.env]
 CONVEX_URL=https://your-project.convex.cloud
 BETTER_AUTH_SECRET=your-secret-at-least-32-characters
 ```
 
-### 4. Create Server Auth Config
+### Create Better Auth config files
+
+`@onmax/nuxt-better-auth` loads these files by default:
+
+- `server/auth.config.ts`
+- `app/auth.config.ts`
 
 ```ts [server/auth.config.ts]
 import { defineServerAuth } from '@onmax/nuxt-better-auth/config'
@@ -51,29 +61,36 @@ export default defineServerAuth(({ runtimeConfig }) => ({
 }))
 ```
 
-### 5. Create Client Auth Config
-
 ```ts [app/auth.config.ts]
 import { defineClientAuth } from '@onmax/nuxt-better-auth/config'
 
 export default defineClientAuth({})
 ```
 
-### 6. Create Convex Auth Functions
+### Create Convex auth functions
 
-Export CRUD functions that the Better Auth adapter will call:
+Create a `convex/auth.ts` file that exports the CRUD functions the adapter calls.
 
 ```ts [convex/auth.ts]
 import { createApi } from '@convex-dev/better-auth'
 import schema from './schema'
 
-export const { create, findOne, findMany, updateOne, updateMany, deleteOne, deleteMany }
-  = createApi(schema, () => ({}))
+export const {
+  create,
+  findOne,
+  findMany,
+  updateOne,
+  updateMany,
+  deleteOne,
+  deleteMany,
+} = createApi(schema, () => ({}))
 ```
 
-### 7. Add Auth Tables to Schema
+### Add auth tables to your Convex schema
+
+Add the Better Auth tables to `convex/schema.ts`.
 
-Add Better Auth tables to your Convex schema:
+::collapsible{title="Example schema (Better Auth tables)"}
 
 ```ts [convex/schema.ts]
 import { defineSchema, defineTable } from 'convex/server'
@@ -138,15 +155,19 @@ export default defineSchema({
 })
 ```
 
-### 8. Deploy Convex
+::
+
+### Deploy Convex
 
 ```bash
 npx convex deploy
 ```
 
+::
+
 ## Usage
 
-### Client-Side
+### Client-side
 
 ```vue
 <script setup lang="ts">
@@ -168,7 +189,7 @@ const { user, signIn, signOut } = useUserSession()
 </template>
 ```
 
-### Server-Side
+### Server-side
 
 ```ts [server/api/protected.ts]
 export default defineEventHandler(async (event) => {
@@ -179,11 +200,11 @@ export default defineEventHandler(async (event) => {
 
 ## Performance
 
-HTTP latency to Convex (~50-200ms per DB call) is acceptable for auth operations:
+HTTP latency to Convex is typically acceptable for auth operations:
 
-- Login/signup are infrequent
-- Use JWE session cookies to minimize DB reads
-- Enable `cookieCache` for session caching
+- Login/signup are infrequent.
+- JWE session cookies minimize DB reads.
+- `cookieCache` reduces repeated session lookups.
 
 ```ts [server/auth.config.ts]
 export default defineServerAuth({
diff --git a/package.json b/package.json
index 8877c8c..a3cdca0 100644
--- a/package.json
+++ b/package.json
@@ -27,6 +27,10 @@
     ".": {
       "types": "./dist/types.d.mts",
       "import": "./dist/module.mjs"
+    },
+    "./better-auth": {
+      "types": "./dist/runtime/better-auth/adapter.d.ts",
+      "import": "./dist/runtime/better-auth/adapter.js"
     }
   },
   "main": "./dist/module.mjs",
@@ -47,6 +51,7 @@
     "dev:build": "nuxi build playground",
     "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare",
     "playground:prepare": "nuxi prepare playground",
+    "pretest": "nuxt-module-build build",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "nuxt-module-build build",
@@ -55,8 +60,14 @@
     "release": "bumpp && git push --follow-tags"
   },
   "peerDependencies": {
+    "better-auth": ">=1.4.9 <1.6.0",
     "convex": ">=1.0.0"
   },
+  "peerDependenciesMeta": {
+    "better-auth": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@nuxt/kit": "catalog:prod",
     "consola": "catalog:prod",
@@ -72,6 +83,7 @@
     "@nuxt/test-utils": "catalog:test",
     "@types/node": "catalog:types",
     "@vue/test-utils": "catalog:test",
+    "better-auth": "catalog:playground",
     "bumpp": "catalog:",
     "convex": "catalog:convex",
     "eslint": "catalog:lint",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 65d6ee1..2495944 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -163,6 +163,9 @@ importers:
       '@vue/test-utils':
         specifier: catalog:test
         version: 2.4.6
+      better-auth:
+        specifier: catalog:playground
+        version: 1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82)
       bumpp:
         specifier: 'catalog:'
         version: 10.4.0(magicast@0.5.1)
@@ -225,13 +228,13 @@ importers:
     dependencies:
       '@convex-dev/better-auth':
         specifier: catalog:convex
-        version: 0.10.10(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@standard-schema/spec@1.1.0)(better-auth@1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82))(better-call@1.1.7(zod@4.3.6))(convex@1.31.6(react@19.2.3))(hono@4.11.4)(nanostores@1.1.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)
+        version: 0.10.10(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@standard-schema/spec@1.1.0)(better-auth@1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82))(better-call@1.2.0(zod@4.3.6))(convex@1.31.6(react@19.2.3))(hono@4.11.4)(nanostores@1.1.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)
       '@nuxthub/core':
         specifier: catalog:playground
         version: 0.10.5(db0@0.3.4(@electric-sql/pglite@0.3.15)(better-sqlite3@12.6.2)(drizzle-orm@0.41.0(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(@types/pg@8.16.0)(better-sqlite3@12.6.2)(kysely@0.28.10)(mysql2@3.15.3)(pg@8.17.2)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(mysql2@3.15.3))(ioredis@5.9.2)(magicast@0.5.1)(synckit@0.11.12)(typescript@5.9.3)
       '@onmax/nuxt-better-auth':
         specifier: catalog:playground
-        version: 0.0.2-alpha.19(patch_hash=d32ce6e179e83bff964f87481990f212582e4b052519829146891afb32846715)(543298b2cef3baaeb79a49133f5d8b31)
+        version: 0.0.2-alpha.19(patch_hash=d32ce6e179e83bff964f87481990f212582e4b052519829146891afb32846715)(5cb072d5f31d6e844213702eafbe9d38)
       better-auth:
         specifier: catalog:playground
         version: 1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82)
@@ -9375,13 +9378,13 @@ snapshots:
       '@babel/helper-string-parser': 7.27.1
       '@babel/helper-validator-identifier': 7.28.5
 
-  '@better-auth/cli@1.5.0-beta.9(@better-fetch/fetch@1.1.21)(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(magicast@0.5.1)(mongodb@7.0.0)(mysql2@3.15.3)(nanostores@1.1.0)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vitest@4.0.18(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(yaml@2.8.2))(vue@3.5.27(typescript@5.9.3))':
+  '@better-auth/cli@1.5.0-beta.9(@better-fetch/fetch@1.1.21)(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(magicast@0.5.1)(mongodb@7.0.0)(mysql2@3.15.3)(nanostores@1.1.0)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vitest@4.0.18(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(yaml@2.8.2))(vue@3.5.27(typescript@5.9.3))':
     dependencies:
       '@babel/core': 7.28.6
       '@babel/preset-react': 7.28.5(@babel/core@7.28.6)
       '@babel/preset-typescript': 7.28.5(@babel/core@7.28.6)
-      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
-      '@better-auth/telemetry': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))
+      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
+      '@better-auth/telemetry': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))
       '@better-auth/utils': 0.3.0
       '@clack/prompts': 0.11.0
       '@mrleebo/prisma-ast': 0.13.1
@@ -9458,17 +9461,6 @@ snapshots:
       nanostores: 1.1.0
       zod: 4.3.6
 
-  '@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)':
-    dependencies:
-      '@better-auth/utils': 0.3.0
-      '@better-fetch/fetch': 1.1.21
-      '@standard-schema/spec': 1.1.0
-      better-call: 1.1.7(zod@4.3.6)
-      jose: 6.1.3
-      kysely: 0.28.10
-      nanostores: 1.1.0
-      zod: 4.3.6
-
   '@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)':
     dependencies:
       '@better-auth/utils': 0.3.0
@@ -9480,44 +9472,44 @@ snapshots:
       nanostores: 1.1.0
       zod: 4.3.6
 
-  '@better-auth/drizzle-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(drizzle-orm@0.41.0(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(@types/pg@8.16.0)(better-sqlite3@12.6.2)(kysely@0.28.10)(mysql2@3.15.3)(pg@8.17.2)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))':
+  '@better-auth/drizzle-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(drizzle-orm@0.41.0(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(@types/pg@8.16.0)(better-sqlite3@12.6.2)(kysely@0.28.10)(mysql2@3.15.3)(pg@8.17.2)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))':
     dependencies:
-      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
+      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
       '@better-auth/utils': 0.3.0
       drizzle-orm: 0.41.0(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(@types/pg@8.16.0)(better-sqlite3@12.6.2)(kysely@0.28.10)(mysql2@3.15.3)(pg@8.17.2)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))
 
-  '@better-auth/kysely-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(kysely@0.28.10)':
+  '@better-auth/kysely-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(kysely@0.28.10)':
     dependencies:
-      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
+      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
       '@better-auth/utils': 0.3.0
       kysely: 0.28.10
 
-  '@better-auth/memory-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)':
+  '@better-auth/memory-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)':
     dependencies:
-      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
+      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
       '@better-auth/utils': 0.3.0
 
-  '@better-auth/mongo-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(mongodb@7.0.0)':
+  '@better-auth/mongo-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(mongodb@7.0.0)':
     dependencies:
-      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
+      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
       '@better-auth/utils': 0.3.0
       mongodb: 7.0.0
 
-  '@better-auth/passkey@1.4.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-auth@1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82))(better-call@1.1.7(zod@4.3.6))(nanostores@1.1.0)':
+  '@better-auth/passkey@1.4.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-auth@1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82))(better-call@1.2.0(zod@4.3.6))(nanostores@1.1.0)':
     dependencies:
-      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
+      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
       '@better-auth/utils': 0.3.0
       '@better-fetch/fetch': 1.1.21
       '@simplewebauthn/browser': 13.2.2
       '@simplewebauthn/server': 13.2.2
       better-auth: 1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82)
-      better-call: 1.1.7(zod@4.3.6)
+      better-call: 1.2.0(zod@4.3.6)
       nanostores: 1.1.0
       zod: 4.3.6
 
-  '@better-auth/prisma-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))':
+  '@better-auth/prisma-adapter@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))':
     dependencies:
-      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
+      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
       '@better-auth/utils': 0.3.0
       '@prisma/client': 5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))
       prisma: 7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)
@@ -9528,9 +9520,9 @@ snapshots:
       '@better-auth/utils': 0.3.0
       '@better-fetch/fetch': 1.1.21
 
-  '@better-auth/telemetry@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))':
+  '@better-auth/telemetry@1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))':
     dependencies:
-      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
+      '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
       '@better-auth/utils': 0.3.0
       '@better-fetch/fetch': 1.1.21
 
@@ -9609,9 +9601,9 @@ snapshots:
 
   '@cloudflare/workers-types@4.20260123.0': {}
 
-  '@convex-dev/better-auth@0.10.10(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@standard-schema/spec@1.1.0)(better-auth@1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82))(better-call@1.1.7(zod@4.3.6))(convex@1.31.6(react@19.2.3))(hono@4.11.4)(nanostores@1.1.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)':
+  '@convex-dev/better-auth@0.10.10(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@standard-schema/spec@1.1.0)(better-auth@1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82))(better-call@1.2.0(zod@4.3.6))(convex@1.31.6(react@19.2.3))(hono@4.11.4)(nanostores@1.1.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)':
     dependencies:
-      '@better-auth/passkey': 1.4.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-auth@1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82))(better-call@1.1.7(zod@4.3.6))(nanostores@1.1.0)
+      '@better-auth/passkey': 1.4.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-auth@1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82))(better-call@1.2.0(zod@4.3.6))(nanostores@1.1.0)
       '@better-fetch/fetch': 1.1.21
       better-auth: 1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82)
       common-tags: 1.8.2
@@ -11412,9 +11404,9 @@ snapshots:
 
   '@one-ini/wasm@0.1.1': {}
 
-  '@onmax/nuxt-better-auth@0.0.2-alpha.19(patch_hash=d32ce6e179e83bff964f87481990f212582e4b052519829146891afb32846715)(543298b2cef3baaeb79a49133f5d8b31)':
+  '@onmax/nuxt-better-auth@0.0.2-alpha.19(patch_hash=d32ce6e179e83bff964f87481990f212582e4b052519829146891afb32846715)(5cb072d5f31d6e844213702eafbe9d38)':
     dependencies:
-      '@better-auth/cli': 1.5.0-beta.9(@better-fetch/fetch@1.1.21)(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(magicast@0.5.1)(mongodb@7.0.0)(mysql2@3.15.3)(nanostores@1.1.0)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vitest@4.0.18(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(yaml@2.8.2))(vue@3.5.27(typescript@5.9.3))
+      '@better-auth/cli': 1.5.0-beta.9(@better-fetch/fetch@1.1.21)(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(magicast@0.5.1)(mongodb@7.0.0)(mysql2@3.15.3)(nanostores@1.1.0)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vitest@4.0.18(@types/node@25.0.10)(jiti@2.6.1)(lightningcss@1.31.1)(terser@5.46.0)(yaml@2.8.2))(vue@3.5.27(typescript@5.9.3))
       '@nuxt/kit': 4.3.0(magicast@0.5.1)
       '@nuxt/ui': 4.4.0(c1c4222c0ae4115eaf6aa50d9ff4d94f)
       better-auth: 1.4.9(5e3b3e2017520fa4d229f7b80d6e2e82)
@@ -13535,12 +13527,12 @@ snapshots:
   better-auth@1.5.0-beta.9(5e3b3e2017520fa4d229f7b80d6e2e82):
     dependencies:
       '@better-auth/core': 1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0)
-      '@better-auth/drizzle-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(drizzle-orm@0.41.0(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(@types/pg@8.16.0)(better-sqlite3@12.6.2)(kysely@0.28.10)(mysql2@3.15.3)(pg@8.17.2)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))
-      '@better-auth/kysely-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(kysely@0.28.10)
-      '@better-auth/memory-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)
-      '@better-auth/mongo-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(mongodb@7.0.0)
-      '@better-auth/prisma-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))
-      '@better-auth/telemetry': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.1.7(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))
+      '@better-auth/drizzle-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(drizzle-orm@0.41.0(@cloudflare/workers-types@4.20260123.0)(@electric-sql/pglite@0.3.15)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(@types/pg@8.16.0)(better-sqlite3@12.6.2)(kysely@0.28.10)(mysql2@3.15.3)(pg@8.17.2)(postgres@3.4.7)(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))
+      '@better-auth/kysely-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(kysely@0.28.10)
+      '@better-auth/memory-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)
+      '@better-auth/mongo-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(mongodb@7.0.0)
+      '@better-auth/prisma-adapter': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))(@better-auth/utils@0.3.0)(@prisma/client@5.22.0(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3)))(prisma@7.3.0(@types/react@19.2.9)(better-sqlite3@12.6.2)(magicast@0.5.1)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.3))
+      '@better-auth/telemetry': 1.5.0-beta.9(@better-auth/core@1.5.0-beta.9(@better-auth/utils@0.3.0)(@better-fetch/fetch@1.1.21)(better-call@1.2.0(zod@4.3.6))(jose@6.1.3)(kysely@0.28.10)(nanostores@1.1.0))
       '@better-auth/utils': 0.3.0
       '@better-fetch/fetch': 1.1.21
       '@noble/ciphers': 2.1.1
diff --git a/src/module.ts b/src/module.ts
index d0fd364..233f1c9 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -11,6 +11,13 @@ import { version } from '../package.json'
 
 const log = consola.withTag('nuxt:convex')
 
+interface BetterAuthDatabaseProviderDefinition {
+  buildDatabaseCode: (ctx: unknown) => string
+  setup?: (ctx: unknown) => void | Promise<void>
+}
+
+type BetterAuthDatabaseProviders = Record<string, BetterAuthDatabaseProviderDefinition>
+
 export default defineNuxtModule<ConvexConfig>({
   meta: {
     name: 'nuxt-convex',
@@ -37,6 +44,39 @@ export default defineNuxtModule<ConvexConfig>({
       { url: config.url },
     )
 
+    nuxt.hook('better-auth:database:providers', (providers: BetterAuthDatabaseProviders) => {
+      providers.convex = {
+        buildDatabaseCode: () => `import { useRuntimeConfig } from '#imports'
+import { createConvexHttpAdapter } from 'nuxt-convex/better-auth'
+import { api } from '#convex/api'
+
+export function createDatabase() {
+  const config = useRuntimeConfig()
+  const convexUrl = config.betterAuth?.convexUrl || config.public?.convex?.url
+  if (!convexUrl) {
+    throw new Error('[nuxt-better-auth] Convex URL not configured. Set auth.database.convexUrl, convex.url, or CONVEX_URL.')
+  }
+  return createConvexHttpAdapter({ url: convexUrl, api: api.auth })
+}
+export const db = undefined
+`,
+        setup: (ctx) => {
+          const hookNuxt = (ctx as { nuxt?: Nuxt } | undefined)?.nuxt
+          if (!hookNuxt)
+            return
+
+          const convexUrl = (hookNuxt.options as { auth?: { database?: { convexUrl?: string } } }).auth?.database?.convexUrl
+          if (!convexUrl)
+            return
+
+          hookNuxt.options.runtimeConfig.betterAuth = defu(
+            (hookNuxt.options.runtimeConfig.betterAuth as Record<string, unknown> | undefined) || {},
+            { convexUrl },
+          )
+        },
+      }
+    })
+
     addPlugin({ src: resolve('./runtime/plugin.client'), mode: 'client' })
 
     // Auto-import composables
diff --git a/src/runtime/better-auth/adapter.ts b/src/runtime/better-auth/adapter.ts
new file mode 100644
index 0000000..74e874c
--- /dev/null
+++ b/src/runtime/better-auth/adapter.ts
@@ -0,0 +1,299 @@
+import type { Where } from 'better-auth/types'
+import type { FunctionReference } from 'convex/server'
+import { createAdapterFactory } from 'better-auth/adapters'
+import { ConvexHttpClient } from 'convex/browser'
+
+// Placeholder type - Convex generates actual table names dynamically in user's schema.
+type TableNames = string
+
+interface ConvexCleanedWhere {
+  field: string
+  value: string | number | boolean | string[] | number[] | null
+  operator?: 'lt' | 'lte' | 'gt' | 'gte' | 'eq' | 'in' | 'not_in' | 'ne' | 'contains' | 'starts_with' | 'ends_with'
+  connector?: 'AND' | 'OR'
+}
+
+function parseWhere(where?: Where | Where[]): ConvexCleanedWhere[] {
+  if (!where)
+    return []
+  const whereArray = Array.isArray(where) ? where : [where]
+  return whereArray.map((w) => {
+    if (w.value instanceof Date)
+      return { ...w, value: w.value.getTime() } as ConvexCleanedWhere
+    return w as ConvexCleanedWhere
+  })
+}
+
+interface PaginationResult<T> {
+  page: T[]
+  isDone: boolean
+  continueCursor: string | null
+  splitCursor?: string
+  pageStatus?: 'SplitRecommended' | 'SplitRequired' | string
+  count?: number
+}
+
+async function handlePagination<T>(
+  next: (opts: { paginationOpts: { numItems: number, cursor: string | null } }) => Promise<PaginationResult<T> & { count?: number }>,
+  { limit }: { limit?: number } = {},
+): Promise<{ docs: T[], count: number }> {
+  const state: { isDone: boolean, cursor: string | null, docs: T[], count: number } = { isDone: false, cursor: null, docs: [], count: 0 }
+
+  const onResult = (result: PaginationResult<T> & { count?: number }): void => {
+    state.cursor = result.pageStatus === 'SplitRecommended' || result.pageStatus === 'SplitRequired'
+      ? (result.splitCursor ?? result.continueCursor)
+      : result.continueCursor
+    if (result.page) {
+      state.docs.push(...result.page)
+      state.isDone = (limit && state.docs.length >= limit) || result.isDone
+      return
+    }
+    if (result.count) {
+      state.count += result.count
+      state.isDone = (limit && state.count >= limit) || result.isDone
+      return
+    }
+    state.isDone = result.isDone
+  }
+
+  do {
+    const result = await next({
+      paginationOpts: {
+        numItems: Math.min(200, (limit ?? 200) - state.docs.length, 200),
+        cursor: state.cursor,
+      },
+    })
+    onResult(result)
+  } while (!state.isDone)
+
+  return state
+}
+
+interface ConvexAuthApi {
+  create: FunctionReference<'mutation', 'public', { input: { model: string, data: Record<string, unknown> }, select?: string[] }, unknown>
+  findOne: FunctionReference<'query', 'public', { model: string, where?: ConvexCleanedWhere[], select?: string[] }, unknown>
+  findMany: FunctionReference<'query', 'public', { model: string, where?: ConvexCleanedWhere[], limit?: number, sortBy?: { direction: 'asc' | 'desc', field: string }, paginationOpts: { numItems: number, cursor: string | null } }, PaginationResult<unknown>>
+  updateOne: FunctionReference<'mutation', 'public', { input: { model: string, where?: ConvexCleanedWhere[], update: Record<string, unknown> } }, unknown>
+  updateMany: FunctionReference<'mutation', 'public', { input: { model: string, where?: ConvexCleanedWhere[], update: Record<string, unknown> }, paginationOpts: { numItems: number, cursor: string | null } }, PaginationResult<unknown> & { count: number }>
+  deleteOne: FunctionReference<'mutation', 'public', { input: { model: string, where?: ConvexCleanedWhere[] } }, unknown>
+  deleteMany: FunctionReference<'mutation', 'public', { input: { model: string, where?: ConvexCleanedWhere[] }, paginationOpts: { numItems: number, cursor: string | null } }, PaginationResult<unknown> & { count: number }>
+}
+
+export interface ConvexHttpAdapterOptions {
+  /** Convex deployment URL (e.g., https://your-app.convex.cloud) */
+  url: string
+  /** Convex API functions for auth operations - import from your convex/_generated/api */
+  api: ConvexAuthApi
+  /** Enable debug logging for adapter operations */
+  debugLogs?: boolean
+}
+
+/**
+ * Creates a Better Auth adapter that communicates with Convex via HTTP.
+ * Uses ConvexHttpClient for server-side auth operations.
+ *
+ * @example
+ * ```ts
+ * import { api } from '~/convex/_generated/api'
+ *
+ * export default defineServerAuth(() => ({
+ *   database: createConvexHttpAdapter({
+ *     url: process.env.CONVEX_URL!,
+ *     api: api.auth,
+ *   }),
+ * }))
+ * ```
+ *
+ * @limitations
+ * - `update()` only supports AND-connected where clauses (no OR support)
+ * - `count()` fetches all documents client-side (Convex limitation)
+ * - `offset` pagination not supported in `findMany()`
+ */
+export function createConvexHttpAdapter(options: ConvexHttpAdapterOptions): ReturnType<typeof createAdapterFactory> {
+  if (!options.url.startsWith('https://') || !options.url.includes('.convex.')) {
+    throw new Error(`Invalid Convex URL: ${options.url}. Expected format: https://your-app.convex.cloud`)
+  }
+
+  const client = new ConvexHttpClient(options.url)
+
+  return createAdapterFactory({
+    config: {
+      adapterId: 'convex-http',
+      adapterName: 'Convex HTTP Adapter',
+      debugLogs: options.debugLogs ?? false,
+      disableIdGeneration: true,
+      transaction: false,
+      supportsNumericIds: false,
+      supportsJSON: false,
+      supportsDates: false,
+      supportsArrays: true,
+      usePlural: false,
+      mapKeysTransformInput: { id: '_id' },
+      mapKeysTransformOutput: { _id: 'id' },
+      customTransformInput: ({ data, fieldAttributes }) => {
+        if (data && fieldAttributes.type === 'date')
+          return new Date(data as string | number | Date).getTime()
+        return data
+      },
+      customTransformOutput: ({ data, fieldAttributes }) => {
+        if (data && fieldAttributes.type === 'date')
+          return new Date(data as number).getTime()
+        return data
+      },
+    },
+    adapter: ({ options: authOptions }) => {
+      // Disable telemetry - HTTP adapter cannot reliably send telemetry from edge/serverless.
+      authOptions.telemetry = { enabled: false }
+      return {
+        id: 'convex-http',
+
+        create: async ({ model, data, select }): Promise<unknown> => {
+          return client.mutation(options.api.create, {
+            input: { model: model as TableNames, data },
+            select,
+          })
+        },
+
+        findOne: async (data): Promise<unknown> => {
+          if (data.where?.every((w: Where) => w.connector === 'OR')) {
+            for (const w of data.where) {
+              const result = await client.query(options.api.findOne, {
+                ...data,
+                model: data.model as TableNames,
+                where: parseWhere(w),
+              })
+              if (result)
+                return result
+            }
+            return null
+          }
+          return client.query(options.api.findOne, {
+            ...data,
+            model: data.model as TableNames,
+            where: parseWhere(data.where),
+          })
+        },
+
+        findMany: async (data): Promise<unknown[]> => {
+          if (data.offset)
+            throw new Error('offset not supported')
+
+          if (data.where?.some((w: Where) => w.connector === 'OR')) {
+            const results = await Promise.all(
+              data.where.map(async (w: Where) =>
+                handlePagination(async ({ paginationOpts }) => {
+                  return client.query(options.api.findMany, {
+                    ...data,
+                    model: data.model as TableNames,
+                    where: parseWhere(w),
+                    paginationOpts,
+                  })
+                }, { limit: data.limit }),
+              ),
+            )
+            const allDocs = results.flatMap(r => r.docs)
+            const uniqueDocs = [...new Map(allDocs.map((d: unknown) => [(d as { _id: string })._id, d])).values()]
+            if (data.sortBy) {
+              return uniqueDocs.sort((a, b) => {
+                const aVal = (a as Record<string, unknown>)[data.sortBy!.field]
+                const bVal = (b as Record<string, unknown>)[data.sortBy!.field]
+                const cmp = aVal! < bVal! ? -1 : aVal! > bVal! ? 1 : 0
+                return data.sortBy!.direction === 'asc' ? cmp : -cmp
+              })
+            }
+            return uniqueDocs
+          }
+
+          const result = await handlePagination(
+            async ({ paginationOpts }) => client.query(options.api.findMany, {
+              ...data,
+              model: data.model as TableNames,
+              where: parseWhere(data.where),
+              paginationOpts,
+            }),
+            { limit: data.limit },
+          )
+          return result.docs
+        },
+
+        // Note: Convex doesn't have a native count query, so we fetch all docs and count client-side.
+        // This is inefficient for large datasets but acceptable for auth tables (typically small).
+        count: async (data): Promise<number> => {
+          if (data.where?.some((w: Where) => w.connector === 'OR')) {
+            const results = await Promise.all(
+              data.where.map(async (w: Where) =>
+                handlePagination(async ({ paginationOpts }) => {
+                  return client.query(options.api.findMany, {
+                    ...data,
+                    model: data.model as TableNames,
+                    where: parseWhere(w),
+                    paginationOpts,
+                  })
+                }),
+              ),
+            )
+            const allDocs = results.flatMap(r => r.docs)
+            const uniqueDocs = [...new Map(allDocs.map((d: unknown) => [(d as { _id: string })._id, d])).values()]
+            return uniqueDocs.length
+          }
+
+          const result = await handlePagination(async ({ paginationOpts }) => client.query(options.api.findMany, {
+            ...data,
+            model: data.model as TableNames,
+            where: parseWhere(data.where),
+            paginationOpts,
+          }))
+          return result.docs.length
+        },
+
+        // Supports single eq or multiple AND-connected conditions (Better Auth's common patterns).
+        update: async (data): Promise<unknown> => {
+          const hasOrConnector = data.where?.some((w: Where) => w.connector === 'OR')
+          if (hasOrConnector) {
+            throw new Error('update() does not support OR conditions - use updateMany() or split into multiple calls')
+          }
+          return client.mutation(options.api.updateOne, {
+            input: {
+              model: data.model as TableNames,
+              where: parseWhere(data.where),
+              update: data.update as Record<string, unknown>,
+            },
+          })
+        },
+
+        updateMany: async (data): Promise<number> => {
+          const result = await handlePagination(async ({ paginationOpts }) => client.mutation(options.api.updateMany, {
+            input: {
+              ...data,
+              model: data.model as TableNames,
+              where: parseWhere(data.where),
+            },
+            paginationOpts,
+          }))
+          return result.count
+        },
+
+        delete: async (data): Promise<void> => {
+          await client.mutation(options.api.deleteOne, {
+            input: {
+              model: data.model as TableNames,
+              where: parseWhere(data.where),
+            },
+          })
+        },
+
+        deleteMany: async (data): Promise<number> => {
+          const result = await handlePagination(async ({ paginationOpts }) => client.mutation(options.api.deleteMany, {
+            input: {
+              ...data,
+              model: data.model as TableNames,
+              where: parseWhere(data.where),
+            },
+            paginationOpts,
+          }))
+          return result.count
+        },
+      }
+    },
+  })
+}
diff --git a/test/better-auth-provider.test.ts b/test/better-auth-provider.test.ts
new file mode 100644
index 0000000..51539df
--- /dev/null
+++ b/test/better-auth-provider.test.ts
@@ -0,0 +1,13 @@
+import { fileURLToPath } from 'node:url'
+import { setup } from '@nuxt/test-utils/e2e'
+import { describe, it } from 'vitest'
+
+const rootDir = fileURLToPath(new URL('./fixtures/better-auth-provider', import.meta.url))
+
+describe('better-auth provider', async () => {
+  await setup({ rootDir, dev: true })
+
+  it('boots with convex provider registered', () => {
+    // assertions are done in the fixture module (throws on failure)
+  })
+})
diff --git a/test/exports/module.yaml b/test/exports/module.yaml
index 8c1aaa5..f00ef11 100644
--- a/test/exports/module.yaml
+++ b/test/exports/module.yaml
@@ -1,2 +1,4 @@
 .:
   default: function
+./better-auth:
+  createConvexHttpAdapter: function
diff --git a/test/fixtures/better-auth-provider/.nuxtrc b/test/fixtures/better-auth-provider/.nuxtrc
new file mode 100644
index 0000000..2e43334
--- /dev/null
+++ b/test/fixtures/better-auth-provider/.nuxtrc
@@ -0,0 +1 @@
+setups.nuxt-convex="0.0.6"
\ No newline at end of file
diff --git a/test/fixtures/better-auth-provider/app.vue b/test/fixtures/better-auth-provider/app.vue
new file mode 100644
index 0000000..7282900
--- /dev/null
+++ b/test/fixtures/better-auth-provider/app.vue
@@ -0,0 +1,5 @@
+<template>
+  <div>
+    better-auth-provider fixture
+  </div>
+</template>
diff --git a/test/fixtures/better-auth-provider/modules/assert-better-auth-provider.ts b/test/fixtures/better-auth-provider/modules/assert-better-auth-provider.ts
new file mode 100644
index 0000000..b729c13
--- /dev/null
+++ b/test/fixtures/better-auth-provider/modules/assert-better-auth-provider.ts
@@ -0,0 +1,28 @@
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+  meta: { name: 'assert-better-auth-provider' },
+  setup(_, nuxt) {
+    nuxt.hook('modules:done', async () => {
+      const providers: Record<string, any> = {}
+      await nuxt.callHook('better-auth:database:providers', providers)
+
+      const convex = providers.convex
+      if (!convex) {
+        throw new Error('[nuxt-convex:test] Expected better-auth convex provider to be registered')
+      }
+
+      await convex.setup?.({ nuxt, options: {}, clientOnly: false, provider: 'convex' })
+
+      const runtimeConvexUrl = (nuxt.options.runtimeConfig as any).betterAuth?.convexUrl
+      if (runtimeConvexUrl !== 'https://override.convex.cloud') {
+        throw new Error(`[nuxt-convex:test] Expected runtimeConfig.betterAuth.convexUrl to be set, got: ${runtimeConvexUrl}`)
+      }
+
+      const code = convex.buildDatabaseCode({ hubDialect: 'sqlite', usePlural: false, camelCase: true })
+      if (!code.includes(`from 'nuxt-convex/better-auth'`) || !code.includes(`from '#convex/api'`)) {
+        throw new Error('[nuxt-convex:test] Expected generated DB code to import nuxt-convex/better-auth and #convex/api')
+      }
+    })
+  },
+})
diff --git a/test/fixtures/better-auth-provider/nuxt.config.ts b/test/fixtures/better-auth-provider/nuxt.config.ts
new file mode 100644
index 0000000..654f43d
--- /dev/null
+++ b/test/fixtures/better-auth-provider/nuxt.config.ts
@@ -0,0 +1,15 @@
+import NuxtConvex from '../../../../src/module'
+import AssertBetterAuthProvider from './modules/assert-better-auth-provider'
+
+export default defineNuxtConfig({
+  modules: [NuxtConvex, AssertBetterAuthProvider],
+  convex: {
+    url: 'https://test.convex.cloud',
+  },
+  auth: {
+    database: {
+      provider: 'convex',
+      convexUrl: 'https://override.convex.cloud',
+    },
+  },
+})
diff --git a/test/fixtures/better-auth-provider/tsconfig.json b/test/fixtures/better-auth-provider/tsconfig.json
new file mode 100644
index 0000000..2729cb9
--- /dev/null
+++ b/test/fixtures/better-auth-provider/tsconfig.json
@@ -0,0 +1,4 @@
+{
+  "extends": "./.nuxt/tsconfig.json",
+  "exclude": ["convex/**"]
+}