Como adicionar e usar um banco de dados no ChanTan Studio

Dê memória ao seu app em cerca de um minuto: conecte um banco de dados com um clique, veja o que seu app salvou, edite linhas na mão e pergunte em português.

Sem banco de dados, seu app esquece tudo no instante em que alguém fecha a página. Com um, ele pode ter contas de verdade, guardar o que as pessoas digitam e mostrar as mesmas informações em qualquer aparelho.

Na prática, para a Doceria da Lu, em Curitiba, é a diferença entre uma página bonita e um site onde as encomendas de bolo ficam salvas — mesmo depois de atualizar a página.

Você não precisa entender de banco de dados. A IA cria as listas e as colunas, escreve todo o código que salva e carrega as informações e liga a proteção de dados para você.

1. Abra “Gerenciar ▾” → “Banco de dados”

No topo do seu projeto, aperte “Gerenciar ▾” e depois “Banco de dados”.

Se este projeto nunca teve um banco de dados, em vez de dados você vê um seletor com o título “Boas-vindas ao Banco de dados” — “Adicione um banco de dados para guardar contas de usuários, salvar dados de forma permanente e construir apps com login, formulários e informações que não se perdem.”

2. Escolha “⚡ Banco de dados ChanTan”

Aperte “Conectar agora →” embaixo de “⚡ Banco de dados ChanTan”. É a opção de um clique e a resposta certa para quase todo mundo.

Escolha “🔷 Seu Supabase” só se você já tem uma conta no Supabase e faz questão de que os dados fiquem lá.

3. Espere cerca de um minuto

A região mais próxima de você é escolhida automaticamente. Você vai ver “Configurando seu banco de dados…” — “Criando seu banco de dados gerenciado — normalmente leva cerca de um minuto. O gerenciador completo abre sozinho quando estiver pronto.”

✅ Pronto. O gerenciador abre sozinho. No lugar do seletor, agora você deve ver a tela de dados do seu app — e seu app já pode salvar informações de forma permanente.

Você também pode simplesmente pedir no chat

Digite algo como “adicione login” ou “salve os dados” e a IA mostra o mesmo seletor.

Quando a IA percebe que uma funcionalidade precisa de dados salvos, ela para antes de escrever qualquer código e mostra um card na conversa:

“Seu app precisa de um banco de dados” — “Vamos usar o Chantan DB por padrão, a menos que você escolha outra opção.”

A opção ChanTan vem marcada como “Padrão”, com uma contagem regressiva de 7 segundos — “Conecta automaticamente em {seconds}s” — ou seja, não fazer nada é uma resposta válida. As alternativas são “Conectar seu próprio Supabase” e “Sem banco de dados — construir só com estado local”. Quando dá certo, você lê “Conectado — continuando sua construção…”

Olhando seus dados

Depois de conectado, “Gerenciar ▾” → “Banco de dados” abre a página “Banco de dados” — “Veja e gerencie os dados guardados no seu app.”

Você vê as listas que seu app salva, cada uma com a quantidade de linhas. Clique em uma para abrir os registros.

Se aparecer “Não dá para atualizar a linha. Esta tabela não tem chave primária.”, essa lista não tem uma coluna de identificação única, então registros individuais não podem ser alterados por esta tela. Peça a mudança no chat.

Fazendo perguntas em português

A caixa “Consulte seus dados” deixa você perguntar coisas como “Mostre todos os usuários que se cadastraram nos últimos 7 dias”. Ela tem três modos — “Chat”, “SQL” e “Gráfico” — e consegue desenhar um gráfico assim que você escolhe os dois eixos.

Essa caixa só olha, nunca altera. Se você pedir para modificar algo, ela responde “A estrutura do banco de dados não pode ser alterada por aqui — peça no chat”. E o conselho está certo: mudanças de estrutura se pedem no chat.

⚠️ O “Editor SQL” dentro de “Avançado” é outra coisa, e é poderoso. Ele avisa — “Heads up: Commands here run on your live database and can change or remove data. Double-check before you run.” (em inglês: os comandos daqui rodam no seu banco de dados que está no ar e podem alterar ou apagar dados; confira duas vezes antes de executar) — e depois executa na hora, sem segunda confirmação e sem desfazer. A maioria dos donos de app nunca precisa dele.

Conectando seu próprio Supabase

Escolher “🔷 Seu Supabase” abre um formulário guiado com o título “Configuração de 3 minutos — siga estes passos”:

1. Crie um projeto no Supabase, se ainda não tiver um.
2. Copie sua URL e sua chave anon (pública). “⚠ NÃO use a service_role — ela dá acesso total de administrador e nunca deve ser compartilhada.”
3. Rode o comando de configuração que ele mostra, usando o botão “Copiar SQL de configuração” — “Isso cria a tabela de dados + os buckets de armazenamento de que seu app precisa. Só uma vez, e é seguro rodar de novo.”
4. Opcional: uma caixa avançada que permite à IA construir integrações do lado do servidor no seu próprio Supabase. Sem ela, todas as suas funcionalidades de dados e arquivos continuam funcionando.

Depois aperte “Testar e conectar”.

Um limite para conhecer: enquanto seu projeto usa o seu próprio Supabase, ChanTan não consegue adicionar, editar nem excluir as pessoas que entram no seu app — ele avisa “Open the Auth tab in your Supabase dashboard.” (abra a aba Auth no painel do seu Supabase). Seu uso também é acompanhado lá: “O uso é gerenciado no seu próprio Supabase.”

Seus dados são protegidos para você

Você não precisa ligar nada. “Seus dados são protegidos automaticamente” — “ChanTan ativa a proteção de dados (Row-Level Security) em cada tabela quando você publica — você não precisa fazer nada.”

A tela “Sugestões” oferece extras opcionais (tornar privados arquivos públicos, bloquear senhas que já vazaram, adicionar login em duas etapas). Nenhuma delas tem botão de corrigir — cada uma diz para pedir a ChanTan no chat, que é o caminho certo.

Quanto custa

Incluído grátis em todo projeto: 0,5 GB de armazenamento de banco de dados, 1 GB de arquivos e 50.000 usuários ativos por mês — além do que o plano Grátis oferece: 10.000 linhas, 1.000 usuários e 500 MB.

Acima da cota grátis, o produto mostra as tarifas — 31,25 créditos por GB de armazenamento de banco de dados por mês, 5,25 créditos por GB de armazenamento de arquivos por mês e 0,8125 crédito por usuário ativo por mês. A cobrança desse uso medido está desligada hoje, então esses valores aparecem, mas não são descontados. Não conte com isso para sempre.

Se por um dia sua carteira não cobrir um nível pago, o projeto volta discretamente para o Grátis — seus dados nunca são apagados. Você é avisado antes: “Créditos baixos. Recarregue para manter seu banco de dados rápido — seus dados estão sempre seguros.”

Níveis de velocidade (“Desempenho do banco de dados”)

Todo nível pago precisa de uma aprovação rápida de um administrador, mesmo que só o card “Dedicado” diga isso. Depois de pedir, você vê “Pedido enviado. Um admin vai analisar seu upgrade em breve — assim que for aprovado, fazemos a troca automaticamente.” A troca leva cerca de um minuto, e seus dados ficam seguros o tempo todo.

Limites, sem rodeios

• Desfazer restaura seus arquivos e seu código, nunca seus dados. Registros excluídos se foram. É exatamente por isso que a IA para e pede sua confirmação no chat antes de rodar qualquer coisa que apague dados de forma permanente — leve essa pergunta a sério.
• Não existe botão de restauração por conta própria para os dados do banco. Se precisar recuperar dados, fale com o suporte — o que é e o que não é salvo em backup explica exatamente o que existe.
• Exportar todos os dados do seu app de uma vez não é uma função de um botão. “Exportar CSV” baixa o que está na tela; para mais do que isso, peça à IA no chat para construir uma exportação dentro do seu próprio app.
• “Configurações de login” está em linguagem de programador e quebra fácil. Não mexa, a menos que a IA tenha pedido especificamente para você alterar algo ali — peça no chat. Só uma lista fixa de configurações pode ser alterada pelo ChanTan; qualquer outra é recusada com “One or more auth settings are not allowed.” (em inglês: uma ou mais configurações de autenticação não são permitidas).

Se algo parecer errado