Troubleshooting

FAQ

Common issues and fixes.

NuxtHub version requirement

This module requires @nuxthub/core version 0.10.0 or higher. Earlier versions may not work correctly with the database schema generation.

pnpm add @nuxthub/core@latest

"Missing server/auth.config.ts"

The module validates config files at build time. Create server/auth.config.ts exporting defineServerAuth(...).

"Missing app/auth.client.ts"

Create app/auth.client.ts exporting createAppAuthClient(baseURL).

No schema file is generated

Ensure NuxtHub DB is enabled and dialect is supported:

hub: { db: { dialect: 'sqlite' } }

Restart dev server after changing Better Auth plugins.

routeRules changes don't apply

routeRules are synced to page meta during pages:extend. Restart dev server after updating route rules.

API routes aren't protected

Only routeRules.role is enforced for /api/**. Use role rules or add your own Nitro middleware.