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.
-- 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.).
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:
# 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.
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.
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.
// 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>
)
}
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.
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:
- Next.js 15 — SSR com cookies httpOnly e middleware
- React + Vite — SPA com session em localStorage
- Vue 3 — composable reutilizável
- Expo — React Native com SecureStore
- Adicionar Row Level Security
- Referência completa do SDK