@tacobase/taco

What happens on install

Four things, automatically, in one command.

Works with every AI coding tool

Any tool that reads project files will find TACOBASE.md and have full context.

What your AI gets to work with

TACOBASE.md contains the full API so AI tools generate correct code, not guesses.

import { createClient } from '@tacobase/client'

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

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

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

// Auth
await db.auth.signUp({ email: 'user@example.com', password: 'secret' })
await db.auth.signIn({ email: 'user@example.com', password: 'secret' })

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

React

Install @tacobase/react alongside for hooks and a drop-in auth component.

import { TacoProvider, useAuth, useCollection } from '@tacobase/react'

// Wrap your app
<TacoProvider url={...} apiKey={...}>
  <App />
</TacoProvider>

// Auth state
const { user, signIn, signUp, signOut, isAuthenticated } = useAuth()

// Paginated data with auto-refresh
const { items, loading, error, refresh } = useCollection('posts', {
  sort: '-created',
  filter: 'published = true',
})

Related packages