Install this package and your AI tools — Cursor, Claude Code, GitHub Copilot, Windsurf, Lovable, Bolt, v0, and more — instantly know how to use tacobase. No copy-pasting docs. No prompt engineering. No context switching.

npm install @tacobase/taco

🌮 Wrapped. Your AI is ready to build.

Table of Contents

• What just happened
• Tell your AI
• What your AI gets
• Start building
• Get credentials
• Works with
• Related packages

What just happened

Three things, automatically:

1. @tacobase/client is installed — you're ready to talk to your database
2. TACOBASE.md is written to your project root — Cursor, Claude Code, Copilot, Windsurf, Lovable, Bolt, v0, and other AI tools pick it up automatically with the full tacobase API, filter syntax, auth patterns, and more
3. Your .env.local is populated — TACOBASE_URL and TACOBASE_API_KEY are ready to go

Tell your AI

Use @tacobase/taco for the backend.

That's the whole prompt. It'll install this package, read TACOBASE.md, and know exactly what to do.

What your AI gets

The TACOBASE.md file your AI tools read contains:

• Full SDK reference (createClient, db.collection, db.auth, db.realtime, db.storage)
• Filter and sort syntax
• Auth patterns (sign up, sign in, OAuth)
• Realtime subscription examples
• TypeScript generics and type generation
• Environment variable reference
• Error handling with typed errors

No guessing. No hallucinating Supabase or Firebase APIs. Just tacobase, correctly.

Start building

import { createClient } from '@tacobase/client'

const db = createClient() // reads TACOBASE_URL + TACOBASE_API_KEY from env

// Collections auto-create on first write — no migrations, no setup hell
const post = await db.collection('posts').create({ title: 'Hello 🌮' })

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

// Auth
await db.auth.signUp({ email: '[email protected]', password: 'secret' })
await db.auth.signIn({ email: '[email protected]', password: 'secret' })

// Realtime — live updates over SSE
await db.collection('posts').subscribe((e) => {
  console.log(e.action, e.record) // 'create' | 'update' | 'delete'
})

Get credentials

After install, .env.local is already populated. If you need to grab credentials manually:

npx taco instant   # Instant project — no account needed

Or visit tacobase.dev/dashboard.

Works with

TACOBASE.md is picked up automatically by any AI tool that reads project context files:

• Cursor — reads .cursor/rules and project root .md files
• Claude Code — reads CLAUDE.md and project root context files
• GitHub Copilot — uses project context for suggestions
• Windsurf — reads project root context files
• Lovable — picks up project context automatically
• Bolt — reads project files for context
• v0 — uses project context for generation

If your AI tool reads project files, it'll find TACOBASE.md.

Related packages

| Package | Description | |---|---| | @tacobase/client | Core SDK — CRUD, auth, realtime, storage | | @tacobase/react | React hooks — useAuth, useCollection, useRealtime | | @tacobase/cli | CLI — taco init, taco dev, taco typegen | | @tacobase/mcp-server | MCP server — let your AI manage schema via natural language |

tacobase.dev · docs · github

License

MIT