All the Reactivity, None of the Boilerplate

import { createClient } from '@tacobase/client'

// Zero config — reads from env
const db = createClient()

// convex/_generated/api.js is auto-generated
import { ConvexProvider, ConvexReactClient }
  from 'convex/react'

const convex = new ConvexReactClient(
  'https://your-deployment.convex.cloud'
)

// Must wrap app in provider
<ConvexProvider client={convex}>
  <App />
</ConvexProvider>

// Collection auto-creates on first write
const post = await db
  .collection('posts')
  .create({ title: 'Hello', published: true })

// Must define schema + mutation first
// convex/schema.ts
import { defineSchema, defineTable }
  from 'convex/server'
import { v } from 'convex/values'

export default defineSchema({
  posts: defineTable({
    title: v.string(),
    published: v.boolean(),
  }),
})

// convex/posts.ts
export const create = mutation({
  args: { title: v.string(), published: v.boolean() },
  handler: async (ctx, args) => {
    return await ctx.db.insert('posts', args)
  },
})

// Client code
await convex.mutation(api.posts.create, {
  title: 'Hello', published: true
})

const posts = await db
  .collection('posts')
  .getList(1, 20, {
    filter: 'published = true',
    sort: '-created',
  })

// Must define query function first
// convex/posts.ts
export const list = query({
  handler: async (ctx) => {
    return await ctx.db
      .query('posts')
      .filter(q => q.eq(q.field('published'), true))
      .order('desc')
      .take(20)
  },
})

// Client code
const posts = useQuery(api.posts.list)

// Built-in, no third party needed
await db.auth.signUp({
  email: 'user@example.com',
  password: 'secure123',
})

await db.auth.signIn({
  email: 'user@example.com',
  password: 'secure123',
})

// Requires Clerk, Auth0, or custom integration
// Example with Clerk:
import { ClerkProvider } from '@clerk/nextjs'

// Wrap app
<ClerkProvider>
  <ConvexProviderWithClerk client={convex}>
    <App />
  </ConvexProviderWithClerk>
</ClerkProvider>

// No built-in email/password auth