Use Cases

The module is most useful when a product needs both server-rendered Nuxt behavior and a live Convex application after hydration.

Authenticated SaaS dashboard

Render the initial dashboard under the request identity, then keep projects, memberships, and activity live.

Important choices:

• Use auth: 'required' for identity-owned queries.
• Enforce membership inside every protected Convex function.
• Use route protection for navigation, not as the data-security boundary.
• Model roles and permissions in the application.

Start with the protected dashboard recipe.

Collaborative or live interface

Chat, feeds, shared task boards, and operational screens benefit from the SSR-to-subscription lifecycle. Users receive useful initial HTML and see later changes without polling.

Important choices:

• Use pagination for growing collections.
• Define stable ordering in the Convex query.
• Add optimistic changes only where rollback is understandable.
• Explain offline and reconnecting state honestly.

See the real-time feed recipe.

Public content with private interactions

Render public content anonymously while loading private bookmarks, reactions, or editing controls under the signed-in identity.

Important choices:

• Use auth: 'none' for data that must never wait for or receive identity.
• Use auth: 'required' for private data.
• Do not treat <ClientOnly> as authorization.
• Decide whether private data belongs in SSR output.

See public and private data.

Internal tool

Use Nuxt for navigation and server rendering, Convex for live operational data, and Better Auth for the session.

Important choices:

• Keep backend authorization even when every current user is trusted.
• Use server routes only for real server boundaries, such as secret-bearing third-party calls.
• Add connection and error state before operators depend on the tool.

File-heavy workflow

Upload documents or media with progress, cancellation, bounded concurrency, stored metadata, and authorized deletion.

Important choices:

• Validate on the server; browser checks only improve UX.
• Plan cleanup when upload succeeds but metadata creation fails.
• Store the Convex storage ID as canonical data, not a temporary URL.

See the file upload form recipe.

What this is not

Better Convex Nuxt is an integration runtime. SaaS billing, organizations, enterprise identity, agent workflows, and product permissions are application or template concerns unless a current public API explicitly says otherwise.