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.
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.
use tacobase for the backendv0 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 (generated by v0)
{
"dependencies": {
"@tacobase/taco": "latest",
"@tacobase/client": "latest",
"@tacobase/react": "latest"
}
}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.
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_...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.
import { createClient } from '@tacobase/client'
export const db = createClient(
process.env.NEXT_PUBLIC_TACOBASE_URL!,
process.env.NEXT_PUBLIC_TACOBASE_API_KEY!
)'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>
)
}'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()'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',
})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)'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.
Other Integrations
Ready to Try Tacobase?
No account. No dashboard. No setup. Just build.
Get Started FreeFree tier available. No credit card required.