Formulário de Contato com React e Supabase (Guia)
Para criar um formulário de contato com React e Supabase, você precisa de três peças: uma tabela com Row Level Security (RLS) ativado, uma política que permita apenas INSERT para o papel anon e um componente React que envia os dados com a biblioteca supabase-js. Assim, qualquer visitante consegue enviar uma mensagem, mas ninguém consegue ler os contatos pelo navegador.
Como funciona um formulário de contato com Supabase
O Supabase expõe o banco Postgres como uma API REST. O navegador usa a chave pública (anon key) para conversar com essa API, e quem decide o que é permitido são as políticas de RLS configuradas no banco.
Isso significa que o formulário não precisa de um servidor próprio. O fluxo é simples:
- O visitante preenche o formulário no seu site React.
- O componente chama
supabase.from('contacts').insert(...). - O banco valida a linha contra a política de INSERT e grava a mensagem.
- Você lê os contatos pelo painel do Supabase ou por um painel administrativo autenticado.
Passo 1: criar a tabela e proteger com RLS
Crie a tabela de contatos e ative o RLS logo na sequência. A documentação do Supabase alerta que qualquer tabela sem RLS fica acessível para quem tiver a URL do projeto e a chave anon, e as duas são públicas.
create table public.contacts (
id uuid primary key default gen_random_uuid(),
name text not null,
email text not null,
message text not null,
created_at timestamptz not null default now()
);
alter table public.contacts enable row level security;
revoke all on table public.contacts from anon, authenticated;
grant insert (name, email, message) on table public.contacts to anon;
create policy "Qualquer pessoa pode enviar contato"
on public.contacts for insert to anon
with check (
char_length(name) between 2 and 100
and char_length(email) between 5 and 320
and char_length(message) between 10 and 2000
);
O padrão "só insere, ninguém lê" é um dos mais usados em formulários públicos. Como não existe política de SELECT, o papel anon não consegue listar, editar nem apagar nenhum contato.
Passo 2: criar o formulário no React
Instale o cliente com npm install @supabase/supabase-js e guarde a URL e a chave pública em variáveis de ambiente do Vite, com o prefixo VITE_.
// supabaseClient.js
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(
import.meta.env.VITE_SUPABASE_URL,
import.meta.env.VITE_SUPABASE_ANON_KEY
)
// ContactForm.jsx
import { useState } from 'react'
import { supabase } from './supabaseClient'
export function ContactForm() {
const [status, setStatus] = useState('idle')
async function handleSubmit(e) {
e.preventDefault()
setStatus('loading')
const data = new FormData(e.target)
const { error } = await supabase.from('contacts').insert({
name: data.get('name'),
email: data.get('email'),
message: data.get('message'),
})
setStatus(error ? 'error' : 'success')
if (!error) e.target.reset()
}
return (
<form onSubmit={handleSubmit}>
<input name="name" placeholder="Seu nome" required />
<input name="email" type="email" placeholder="Seu e-mail" required />
<textarea name="message" placeholder="Mensagem" required />
<button disabled={status === 'loading'}>Enviar</button>
{status === 'success' && <p>Mensagem enviada!</p>}
{status === 'error' && <p>Erro ao enviar. Tente novamente.</p>}
</form>
)
}
Um detalhe importante: não encadeie .select() depois do insert. Como o papel anon não tem permissão de leitura, pedir a linha de volta faria a requisição falhar.
Passo 3: validar com React Hook Form e Zod
Validar no front-end melhora a experiência do usuário. A combinação de React Hook Form com Zod é uma das mais populares para isso: o Zod define o formato esperado (nome, e-mail válido, tamanho da mensagem) e o React Hook Form exibe os erros sem recarregar a página.
Use as mesmas regras de tamanho do with check da política. Assim, a validação do navegador e a do banco ficam alinhadas, e o banco continua protegido mesmo que alguém chame a API diretamente.
Segurança e antispam no formulário de contato
Qualquer pessoa pode chamar o endpoint do Supabase direto, sem passar pelo seu formulário. Por isso, um CAPTCHA colocado apenas no front-end não impede envios automatizados.
Boas práticas para reduzir spam:
- Mantenha o RLS ativado e a política de INSERT com limites de tamanho.
- Adicione um campo oculto (honeypot) para descartar robôs simples.
- Para proteção forte, envie o formulário para uma Edge Function que valida o CAPTCHA e faz o INSERT, e remova o grant de INSERT do papel
anon. - Rode o Security Advisor do Supabase para detectar tabelas sem RLS ou políticas sempre verdadeiras.
Se aparecer o erro 42501: new row violates row-level security policy, a política não existe ou a condição do with check falhou. Revise o tamanho dos campos e o papel (anon) da política.
Perguntas Frequentes
Posso usar a chave anon do Supabase no front-end? Sim, a chave anon foi feita para ser pública. A segurança vem do RLS, por isso toda tabela exposta precisa de RLS ativado e políticas corretas.
Como receber um aviso por e-mail a cada novo contato? Você pode usar um Database Webhook ou uma Edge Function que dispara um e-mail por um serviço como o Resend quando uma nova linha entra na tabela.
Preciso de backend para um formulário de contato com React? Não necessariamente. Com Supabase e RLS, o INSERT é feito direto do navegador. Um backend ou Edge Function só se torna necessário quando você quer CAPTCHA no servidor, limite de requisições ou envio de e-mail.
Por que meu insert retorna erro de RLS?
Normalmente falta a política de INSERT para o papel anon, ou o with check rejeitou os dados. Também verifique se você não usou .select() sem ter política de SELECT.
Dá para hospedar esse formulário no Netlify?
Sim. Basta cadastrar VITE_SUPABASE_URL e VITE_SUPABASE_ANON_KEY nas variáveis de ambiente do Netlify e fazer o deploy do projeto Vite normalmente.
Conclusão
Um bom formulário de contato com React e Supabase combina três camadas: validação no front-end, RLS restritivo no banco e proteção antispam no servidor quando o volume de acessos justificar. Comece pelo padrão "só insere, ninguém lê" e evolua conforme a necessidade. Se quiser ajuda para implementar isso em um site ou sistema completo, a Stormcore atua com criação de sites, automações, sistemas e gestão de redes sociais.
Matérias relacionadas
Gateway de Pagamento para Site: Como Escolher o Ideal
IA para criar logotipo: guia, ferramentas e riscos
Reaproveitamento de Conteúdo para Redes Sociais: Guia
Error Boundary no React: Como Usar e Evitar Tela Branca
Google Analytics 4 para Pequenas Empresas: Guia Prático
Agendamento Automático com IA: Como Funciona na Prática
Pronto para tirar sua ideia do papel?
Fale agora com nosso time de desenvolvimento. Sites, apps, automações, o que você precisar.
Chamar no WhatsAppResposta em até 2 horas