Démarrage rapide

Nous supposons que Node.js ≥ 20est installé et qu'un terminal POSIX est à portée. Aucune base de données locale n'est requise : Aurabase provisionne un schéma Postgres dédié à chaque projet.

Le SDK officiel expose un client typé pour CRUD, auth, realtime et storage. Il fonctionne de la même façon en Next.js, React, Node, Bun ou Deno.

# Recommandé
pnpm add @aurabase/client

Depuis le Studio, chaque projet reçoit quatre sous-schémas isolés. Vous récupérez un PROJECT_URL et un ANON_KEY publiables côté client, plus une SERVICE_ROLE_KEY à garder strictement côté serveur.

Créez un client Aurabase réutilisable en lisant les clés depuis les variables d'environnement, puis interrogez votre première table.

import { createClient } from '@aurabase/client'
import type { Database } from './aurabase.types'
export const aura = createClient<Database>(
  process.env.AURA_URL!,
  process.env.AURA_ANON_KEY!,
)

Puis, dans une route handler ou un server component :

import { aura } from '@/lib/aurabase'
export async function GET() {
  const { data, error } = await aura
    .from('sensors')
    .select('id, value, captured_at')
    .order('captured_at', { ascending: false })
    .limit(10)
  if (error) throw error
  return Response.json(data)
}

Trois transports auto-négociés : WebSocket, SSE, NATS. Le client choisit le meilleur selon le réseau — aucune configuration nécessaire.

'use client'
import { aura } from '@/lib/aurabase'
import { useEffect } from 'react'
export function LiveSensors() {
  useEffect(() => {
    const channel = aura.channel('sensors:live')
      .on('INSERT', ({ new: row }) => console.log(row))
      .subscribe()
    return () => channel.unsubscribe()
  }, [])
}