Carregando recursos ...
formulario de contato com react e supabasereactsupabaserow level securityvitereact hook form

Formulário de Contato com React e Supabase (Guia)

SCStormcore
6 min de leitura

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.

code
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_.

code
// 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
)
code
// 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:

  1. Mantenha o RLS ativado e a política de INSERT com limites de tamanho.
  2. Adicione um campo oculto (honeypot) para descartar robôs simples.
  3. 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.
  4. 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.

Continue lendo

Matérias relacionadas

Pronto para tirar sua ideia do papel?

Fale agora com nosso time de desenvolvimento. Sites, apps, automações, o que você precisar.

Chamar no WhatsApp

Resposta em até 2 horas