Pular para o conteúdo
☁️ QUICKSTART

Projeto no Cloud em 5 minutos.

Login, crie um projeto, copie as API keys e faça sua primeira query — passo a passo real.

O que você vai construir

Ao final deste guia você terá um projeto ativo no cloud do SuperDB com:

  • Projeto isolado com schema Postgres próprio
  • API keys copiadas e prontas
  • SDK instalado e cliente criado
  • Primeira tabela e primeira query funcionando
💡

Tempo estimado: 5–7 minutos. Sem cartão de crédito. O plano free inclui 5.000 usuários ativos, 500 MB de banco e 1 projeto.

Passo a passo

1Login e criar projeto

Acesse app.superdb.com.br/login e faça login com email e senha (ou crie uma conta grátis).

Na tela /projects, clique em + Novo projeto. Preencha apenas o nome — por exemplo, Meu Blog. O slug é gerado automaticamente: meu_blog.

Clique em Criar projeto. Em aproximadamente 1 segundo você é redirecionado para /projects/meu_blog.

bastidores (automático)
-- O SuperDB executa isso pra você:
CREATE SCHEMA proj_meu_blog;
-- + 5 tabelas de auth isoladas
-- + role dedicado com GRANTs
-- + JWT secret próprio
-- + free trial 30 dias ativado

2Copiar API Keys

No sidebar do projeto, clique no botão verde Connect (topo) ou vá em ⌨ API Keys no menu lateral.

O modal exibe:

  • URL do projeto: https://auth.superdb.com.br
  • Anon Key: JWT começando com eyJhbGc…
  • Service Role Key: mascarada por padrão — clique para revelar
⚠️

Anon Key = pública (pode ir pro browser/app). Service Role Key = secreta — nunca exponha no client. Só use em servidor (Node.js, Edge Functions, etc.).

.env.local
NEXT_PUBLIC_SUPERDB_URL=https://auth.superdb.com.br
NEXT_PUBLIC_SUPERDB_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
SUPERDB_SERVICE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...SERVICE...

3Instalar o SDK

O SDK @superdb/auth-js funciona em Node.js, browser, Bun e Deno. Use o gerenciador de pacotes da sua preferência:

terminal
# npm
npm install @superdb/auth-js

# bun
bun add @superdb/auth-js

# pnpm
pnpm add @superdb/auth-js

4Criar o cliente

Crie o arquivo lib/superdb.ts (ou .js) na raiz do seu projeto. Este cliente é singleton — importe-o de qualquer lugar do app.

Use as variáveis de ambiente do passo 2 para conectar ao seu projeto específico.

lib/superdb.ts
import { createClient } from '@superdb/auth-js'

export const superdb = createClient(
  process.env.NEXT_PUBLIC_SUPERDB_URL!,
  process.env.NEXT_PUBLIC_SUPERDB_ANON_KEY!
)

5Criar uma tabela

No dashboard do projeto, vá em 🗄 Banco de dados e clique em + Nova tabela, ou abra o SQL Editor e execute o SQL ao lado.

A tabela já estará disponível via API REST automaticamente — nenhuma configuração extra necessária.

SQL Editor
CREATE TABLE posts (
  id      serial PRIMARY KEY,
  title   text    NOT NULL,
  body    text,
  created_at timestamptz DEFAULT now()
);

-- Habilitar acesso público de leitura (opcional)
ALTER TABLE posts ENABLE ROW LEVEL SECURITY;
CREATE POLICY posts_public_read ON posts
  FOR SELECT USING (true);

6Primeira query

Dados são lidos diretamente via HTTP contra https://api.superdb.com.br — o endpoint PostgREST do SuperDB. O caminho é a raiz da tabela, sem prefixo /rest/v1/.

Para queries tipadas, você pode usar @supabase/supabase-js apontando para api.superdb.com.br (sem sufixo de path).

⚠️

@superdb/auth-js é apenas auth. Ele não tem .from(). Para dados, use HTTP direto ou @supabase/supabase-js com a URL api.superdb.com.br. @superdb/supabase-compat também expõe .from() mas a implementação atual retorna erro not_implemented — use HTTP direto.

Opção A — fetch direto (recomendado)
// app/page.tsx
const ANON_KEY = process.env.NEXT_PUBLIC_SUPERDB_ANON_KEY!

export default async function Page() {
  const res = await fetch('https://api.superdb.com.br/posts?order=created_at.desc', {
    headers: {
      'Authorization': `Bearer ${ANON_KEY}`,
      'apikey': ANON_KEY,
    },
  })
  const posts = await res.json()

  return (
    <ul>
      {posts.map((post: any) => (
        <li key={post.id}>{post.title}</li>
      ))}
    </ul>
  )
}
Opção B — @supabase/supabase-js apontando pro SuperDB
import { createClient } from '@supabase/supabase-js'

// URL base = api.superdb.com.br (sem /rest/v1/)
const db = createClient('https://api.superdb.com.br', ANON_KEY)

const { data: posts, error } = await db
  .from('posts')
  .select('*')
  .order('created_at', { ascending: false })

7Verificar no dashboard

Volte para app.superdb.com.br, abra seu projeto e vá em 🗄 Banco de dados. Você verá a tabela posts com as linhas inseridas.

O SQL Editor também permite explorar os dados interativamente com autocomplete.

dashboard
app.superdb.com.br/projects/meu_blog
  ├── 🗄 Banco de dados
  │     └── posts (1 registro)
  ├── ⌨ SQL Editor
  ├── 👤 Auth / Usuários
  └── 🔑 API Keys

Próximos passos

Você tem um projeto funcionando no cloud. Agora escolha seu framework:

Essa página ajudou?