Tacobase × v0

The backend v0 apps are missing

Full database, auth, realtime, and file storage for your v0 Next.js app — auto-provisioned when you run npm install. No account, no dashboard, no setup.

What is v0?

v0 is Vercel's AI-powered UI and code generation tool. Describe your app in plain English and v0 generates production-ready Next.js and shadcn/ui code. v0 handles the frontend; tacobase handles the backend.

Zero-Config Setup

A live backend — database, auth, realtime, and storage — without touching a dashboard.

1

Tell v0 to use tacobase

Say this in your v0 prompt. v0 fetches the tacobase guide and generates Next.js code with @tacobase/taco in package.json.

prompt
use tacobase for the backend
2

v0 generates your app with tacobase wired in

v0 generates a complete Next.js app with @tacobase/taco, @tacobase/client, and @tacobase/react in package.json, plus a lib/tacobase.ts client, a Providers wrapper, and components using useAuth, useCollection, and useRealtime.

package.json
// package.json (generated by v0)
{
  "dependencies": {
    "@tacobase/taco": "latest",
    "@tacobase/client": "latest",
    "@tacobase/react": "latest"
  }
}
3

npm install auto-provisions your backend

When you run npm install in the project, the @tacobase/taco postinstall script calls POST /api/instant and writes credentials to .env.local — no account, no dashboard.

terminal
npm install

# postinstall runs automatically:
# → calls POST https://tacobase.dev/api/instant
# → writes to .env.local:
NEXT_PUBLIC_TACOBASE_URL=https://spicy-bold-taco.tacobase.dev
NEXT_PUBLIC_TACOBASE_API_KEY=tbk_...
4

Claim your project, then add env vars to Vercel

Instant projects expire in 24 hours. Claim yours at the URL in .env.local. For Vercel deploys, add NEXT_PUBLIC_TACOBASE_URL and NEXT_PUBLIC_TACOBASE_API_KEY in the Vercel dashboard → Project → Settings → Environment Variables.

SDK Patterns for Next.js

Copy-paste ready. Env vars use the NEXT_PUBLIC_ prefix.

lib/tacobase.ts — client singleton
import { createClient } from '@tacobase/client'

export const db = createClient(
  process.env.NEXT_PUBLIC_TACOBASE_URL!,
  process.env.NEXT_PUBLIC_TACOBASE_API_KEY!
)
app/providers.tsx — wrap client components
'use client'
import { TacoProvider } from '@tacobase/react'

export function Providers({ children }: { children: React.ReactNode }) {
  return (
    <TacoProvider
      url={process.env.NEXT_PUBLIC_TACOBASE_URL!}
      apiKey={process.env.NEXT_PUBLIC_TACOBASE_API_KEY!}
    >
      {children}
    </TacoProvider>
  )
}
Auth — client component
'use client'
import { useAuth, AuthForm } from '@tacobase/react'

// Drop-in auth UI:
<AuthForm providers={['google', 'github']} onSuccess={() => window.location.reload()} />

// Custom:
const { user, loading, signIn, signOut } = useAuth()
Database — client hook
'use client'
import { useCollection } from '@tacobase/react'

// Read (collections auto-create on first write):
const { data: posts, loading } = useCollection('posts', {
  sort: '-created',
  filter: 'published = true',
})
Database — server component / API route
import { db } from '@/lib/tacobase'

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

// Write:
await db.collection('posts').create({ title: 'Hello', published: true })
await db.collection('posts').update(id, { title: 'Updated' })
await db.collection('posts').delete(id)
Realtime — client component
'use client'
import { useRealtime } from '@tacobase/react'

useRealtime('posts', (event) => {
  console.log(event.action, event.record) // 'create' | 'update' | 'delete'
})

Everything v0 Projects Need

Zero-config via package.json

v0 adds @tacobase/taco to package.json. When you run npm install, the postinstall provisions a live backend and writes credentials to .env.local automatically.

Next.js App Router ready

tacobase supports both server and client components. Use db directly in Server Components and API routes; use hooks from @tacobase/react in Client Components.

Collections on demand

No schema setup, no migrations. Collections create themselves the first time you write data. v0 can define any data model without touching a dashboard.

Drop-in auth

Email/password and OAuth (Google, GitHub) with a single component. useAuth gives you user, signIn, signOut — works inside Client Components.

Realtime built in

WebSocket subscriptions on any collection with useRealtime. Live feeds and collaborative features inside Client Components — no extra infrastructure.

Vercel-compatible

tacobase is a hosted BaaS that works with any Vercel deployment. Add your credentials to Vercel environment variables and deploy without any backend config.

Frequently Asked Questions

How does zero-config work if v0 only generates code?

v0 includes @tacobase/taco in the generated package.json. When you run npm install locally, the postinstall script fires, calls the tacobase instant API, and writes NEXT_PUBLIC_TACOBASE_URL and NEXT_PUBLIC_TACOBASE_API_KEY to .env.local. You never manually set a credential.

Why doesn't Vercel CI auto-provision?

The postinstall script skips provisioning when CI=true (which Vercel sets automatically) to avoid creating throwaway projects on every deploy. For production, claim your instant project and add the credentials in the Vercel dashboard under Project → Settings → Environment Variables.

Do I need to use "use client" for tacobase?

Only for hooks. The @tacobase/react hooks (useAuth, useCollection, useRealtime) require Client Components and need "use client" at the top of the file. The createClient SDK from @tacobase/client works in both Server Components and Client Components.

Do I need to set up database tables or a schema?

No. tacobase collections auto-create on first write. When your app calls db.collection("posts").create(...) for the first time, the "posts" collection is created automatically with whatever fields you use. No SQL, no migrations.

Do I need a tacobase account?

Not to start. The instant provisioning API creates a live project with no account required. You only need an account to claim the project and keep it permanently. Instant projects expire after 24 hours.

Is tacobase free?

Yes. The Soft tier is free and includes 2 projects and 1 GB storage. Paid plans (Crunchy at $7/mo, Loaded at $19/mo) add more projects and storage.

Ready to Try Tacobase?

No account. No dashboard. No setup. Just build.

Get Started Free

Free tier available. No credit card required.