Choose Your Path

Start with the smallest path that proves the integration you need.

New Nuxt and Convex app

Follow the complete golden path:

1. Install Better Convex Nuxt.
2. Render a real-time page.
3. Add a mutation.
4. Add authentication only if the product needs it.

The first three steps use auth: false. This keeps the initial setup focused on Nuxt, Convex, SSR, and live data.

Existing Nuxt and Convex app

Start with installation, then replace one existing integration path at a time.

Before removing your current client plugin, identify who currently owns:

• client construction and teardown;
• SSR data and hydration;
• authentication tokens;
• subscriptions;
• server-side calls.

Do not keep the old client path beside Better Convex Nuxt after the replacement works. Two client owners create duplicate subscriptions and conflicting auth lifecycle.

Nuxt, Convex, and Better Auth

Complete the public query and mutation first. Then follow:

1. Add authentication.
2. Protect data.

Authentication is enabled when convex.auth is omitted or an object. A Convex-only app must set auth: false explicitly.

Start from a maintained example

The repository contains focused starters:

• starters/public for a public real-time todo app
• starters/team for a production-shaped Better Auth organization/team application

Use the public starter to learn the runtime. Use the team starter when you need the full local Better Auth component, product authorization, user projection, and organization workflows.