HyperFrames — Supabase Starter
Toda a integração com Supabase em uma skill: banco de dados (PostgreSQL + RLS), autenticação (provedores OAuth, sessões), armazenamento (buckets de arquivos), e Edge Functions (serverless TypeScript).
Para o contrato de composição (atributos de dados, subcomposições, determinismo) veja hyperframes-core.
Padrão: conectar ao projeto Supabase
Use createClient do pacote @supabase/supabase-js com as variáveis de ambiente VITE_SUPABASE_URL e VITE_SUPABASE_ANON_KEY. O skill fornece um helper useSupabase() que retorna o cliente já configurado.
Configuração inicial
- Crie um projeto em supabase.com e copie as credenciais.
- Adicione ao
.env.local:
VITE_SUPABASE_URL=https://seu-projeto.supabase.co
VITE_SUPABASE_ANON_KEY=sua-chave-anon
- Instale o pacote:
npm install @supabase/supabase-js
Rotas de consulta
| Quer… | Leia |
|---|---|
| Modelos de tabelas SQL (users, profiles) | tables/seed.sql |
| Políticas RLS para segurança | tables/rls-policies.sql |
| Funções de autenticação (signUp, signIn) | auth/auth-functions.ts |
| Configuração de provedores OAuth | auth/oauth-providers.md |
| Gerenciamento de sessão e refresh | auth/session-management.ts |
| Operações CRUD com filtros e paginação | database/crud-operations.ts |
| Subscrições em tempo real (Realtime) | database/realtime-subscriptions.ts |
| Upload/download de arquivos | storage/storage-operations.ts |
| Edge Functions (serverless) | functions/edge-functions.md |
Escolhendo a estratégia de consulta
- SQL direto — use
supabase.rpc()para chamar funções SQL personalizadas. - Query Builder — use
supabase.from('tabela').select('*')para consultas típicas. - Realtime — ative Realtime na tabela no dashboard Supabase e use
supabase.channel('nome').on('postgres_changes', ...). - Edge Functions — para lógica serverless que requer bibliotecas externas ou acesso a APIs.
Scripts auxiliares
node skills/supabase-starter/scripts/apply-migrations.mjs --up
Aplica as migrações SQL definidas em migrations/ ao projeto Supabase. Use --dry-run para visualizar antes de aplicar.
Restrições importantes
Pré-requisito: hyperframes-core → Regras inegociáveis (timeline pausada única, data-duration define duração, sem Math.random, sem repeat: -1, etc.). Não as repita aqui.
Adições específicas deste skill:
- Variáveis de ambiente obrigatórias —
VITE_SUPABASE_URLeVITE_SUPABASE_ANON_KEYdevem estar definidas antes de usar qualquer função deste skill. - Chave anônima é segura para frontend — use RLS no banco, nunca exponha a chave
service_role. - Sessões expiradas — o cliente Supabase renova automaticamente tokens de sessão, mas é recomendado verificar
supabase.auth.getSession()após carregar a página.
Veja também
hyperframes-core— estrutura de composição, atributos de dados, subcomposições, contrato de renderização determinísticahyperframes-creative— paletas, tipografia, narração, planejamento de batidas (direção criativa não-animação)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render