Publique e cresça
Checklist de lançamento
As verificações de segurança e qualidade que a Buildliy faz antes de o seu app ir ao ar, quais delas impedem a publicação e como corrigir cada uma.
Antes de o seu app ir ao ar, a Buildliy procura problemas que podem prejudicar você ou as pessoas que usam o app, como chaves privadas que qualquer um poderia copiar ou páginas que mostram os dados de outras pessoas. Ela também aponta coisas menores que vale a pena ajustar, como links quebrados ou uma página sem título.
Só os problemas graves impedem você de publicar. O resto é sugestão, e é você quem decide se quer corrigir.
Onde encontrar
Você vê as mesmas verificações em dois lugares:
- Na janela Publicar. Clique em Publicar, e o cartão Verificação de segurança antes de publicar aparece no topo. Ele lista o que precisa de atenção, e a maioria dos itens tem um botão Corrigir. Clique em Mostrar … verificações aprovadas para ver o que passou.
- Na aba Lançamento. Abra o menu Visão geral, no canto superior direito, e escolha Lançamento. Você vê todas as verificações, inclusive as que passaram, uma frase curta de resumo, como "Pronto para publicar — 2 itens que vale corrigir", e uma nota de prontidão de até 100.
As verificações rodam de novo toda vez que você abre a janela ou a aba, e também quando você clica em Publicar. Por isso, a lista que você vê é exatamente o que a publicação exige.
A nota de prontidão é um guia, não uma exigência. Uma nota baixa nunca impede você de publicar. Só os itens marcados com Impede a publicação (ou "Grave", na janela Publicar) impedem.
O que impede a publicação
Estes são problemas críticos. A publicação fica bloqueada até que eles sejam corrigidos.
| Verificação (como aparece na aba Lançamento) | O que significa |
|---|---|
| Segredos no código | Uma chave privada, um token ou uma senha está escrita no código do seu app, onde qualquer visitante poderia copiá-la. Isso inclui uma chave de servidor colocada em uma configuração NEXT_PUBLIC_, que é enviada para todos os navegadores. |
| Chave privada do app em código do navegador | A chave da Buildliy do seu próprio app (usada para a IA integrada, os pagamentos, o armazenamento de arquivos e outros serviços) pode ser lida no navegador. Assim, alguém poderia usá-la e gastar os seus créditos. |
| Login ausente | O seu plano diz que as pessoas fazem login, mas o app não tem login. Então tudo o que deveria ser privado fica aberto para qualquer pessoa que tenha o link. |
| Os dados de algumas pessoas não estão trancados só para elas | Em um app novo, uma tabela que guarda os dados de cada pessoa não está protegida pelo banco de dados. Assim, uma página que esquecer de checar quem fez login poderia mostrar os dados de todo mundo. |
| Seu app mostra dados de … | O app usa uma conta conectada que guarda os seus registros privados, como livros contábeis, registros de funcionários, transcrições de reuniões ou um conector personalizado que você marcou como Só eu — é pessoal, e o app não tem login. |
| Sem página inicial | O app não tem uma página principal onde os visitantes possam chegar. |
A verificação profunda de segurança (veja abaixo) também pode acrescentar itens graves, como Alguém poderia mudar um preço antes de pagar, ou uma página ou um link de dados em que qualquer pessoa consegue ver os detalhes de outras.
Como os dados das pessoas são protegidos em um app novo
Em um app novo na hospedagem da Buildliy, o próprio banco de dados mantém os dados de cada pessoa separados: o app se conecta com um acesso restrito, e o banco de dados mostra a cada pessoa só as linhas dela, mesmo que uma página esqueça de checar quem fez login. O checklist mostra isso como uma verificação aprovada: Os dados de cada pessoa ficam trancados pelo banco de dados. Se uma tabela que guarda os dados das pessoas não estiver protegida, Os dados de algumas pessoas não estão trancados só para elas impede a publicação até que isso seja corrigido.
Nos apps criados antes, os dados de cada pessoa ficam separados apenas pelo código do app: cada página checa quem fez login e carrega só as linhas dessa pessoa. O checklist lista Os dados de cada pessoa são separados pelo código do seu app como algo que vale corrigir, para você saber que isso depende de todas as páginas fazerem essa checagem. Isso não impede a publicação. Nos dois casos, a verificação profunda de segurança também procura páginas e links de dados que entregam os detalhes das pessoas para a pessoa errada, e isso pode impedir a publicação.
Alguns apps mais antigos, feitos na configuração anterior de banco de dados da Buildliy, recebem três verificações de acesso aos dados nas tabelas: Tabelas sem proteção, Segurança por linha não testada e A verificação de acesso aos dados falhou. Elas impedem a publicação até que as tabelas estejam protegidas e a verificação passe. Rode a verificação em Gerenciar → Banco de dados.
O que vale corrigir
Estes itens nunca impedem a publicação, mas corrigi-los deixa o seu app melhor e mais seguro.
- A última criação falhou: a sua criação mais recente terminou com um erro, então as mudanças dela não foram salvas. A publicação usa a sua última versão salva.
- Chave de API necessária: o seu app lê uma chave que não tem nenhum valor salvo, então esse recurso não vai funcionar depois de publicado.
- Pagamentos ausentes: o seu plano diz que você recebe pagamentos, mas nenhum checkout foi criado.
- Os pagamentos estão em modo de teste: o checkout só aceita cartões de teste até você conectar o Stripe. Isso é normal antes de publicar, porque o Stripe verifica o seu site no ar antes de ativar os pagamentos reais.
- Adicione uma página de …: para apps que recebem pagamentos, um lembrete para adicionar política de privacidade, termos e política de reembolso. Os compradores procuram por elas, e o Stripe verifica se existem antes de ativar os pagamentos reais.
- Links internos quebrados: links que levam a uma página que não existe.
- Imagens sem texto alternativo: imagens sem descrição para leitores de tela e mecanismos de busca.
- Campos do formulário sem rótulo: campos de formulário que os leitores de tela não conseguem nomear.
- Faltam o título e a descrição da página, ou O título do site ainda é um texto provisório: o que os resultados de busca e os links compartilhados vão mostrar.
- Sem tela de erro alternativa: não há uma página amigável caso algo quebre.
- A tela do celular está com largura fixa: nos celulares, a página apareceria reduzida.
- Os dados de cada pessoa são separados pelo código do seu app: aparece em apps criados antes. Funciona, mas depende de todas as páginas checarem quem fez login.
- Confira o que seu app mostra de …: o seu app usa um serviço que guarda os dados dos seus clientes, como um CRM, uma lista de newsletter, uma caixa de suporte ou respostas de formulários, e não tem login. Formulários que só enviam dados não têm problema. Coloque atrás do login qualquer página que mostre o que está guardado ali.
- Confira quem pode fazer login — seu app mostra dados de …: o seu app mostra dados privados de uma conta conectada atrás do login. Garanta que só você, ou as pessoas que você escolher, possam se cadastrar e fazer login.
- Plano pulado ou Plano não está pronto: a IA teve menos contexto sobre para quem é o app.
A verificação profunda de segurança
Além das verificações acima, a Buildliy olha mais de perto como o seu app poderia ser usado de forma indevida. Enquanto ela roda, o cartão mostra "Verificando seu app, inclusive com um olhar de fora, como faria um estranho…"
Ela procura:
- Dados das pessoas chegando a quem não deveria. Páginas ou links de dados que mostram nomes, e-mails, telefones ou registros salvos para visitantes que não fizeram login, ou para todas as contas com login em vez de só para a proprietária dos dados.
- Preços que os visitantes podem mudar. Um checkout que pega o preço do navegador do visitante, em vez de buscá-lo no servidor.
- Recursos de IA que qualquer um pode usar demais. Um recurso de IA sem login e sem limite por visitante, o que poderia aumentar os seus custos. Este item é uma sugestão, não impede a publicação.
- Um olhar de fora. Quando a sua prévia está rodando, a Buildliy abre os links de dados do seu app sem fazer login, como um estranho faria. Se algum deles entrega os detalhes das pessoas, é um problema grave. Se nada vazar, você vê Verificado por fora na lista de aprovados.
Quando uma verificação tem certeza de que há um problema com os dados, ele é grave. Quando ela tem menos certeza, ele aparece como algo que vale corrigir, para você dar uma olhada.
Corrija os problemas com um clique
Na janela Publicar, cada item tem um título em linguagem simples e uma linha explicando por que ele importa. Clique em Detalhes para ver a parte técnica, como nomes de arquivos.
- Corrigir envia só aquele item para a IA como um pedido. É uma criação normal e usa créditos como qualquer outra.
- Corrigir e publicar (ou Corrigir os dois e publicar, ou Corrigir os 3 e publicar) envia todos os itens graves para a IA em um único pedido. Quando a criação termina, a Buildliy roda a verificação de segurança de novo e publica se não sobrar nada grave. Um aviso acima da caixa do chat diz "Vou publicar assim que as correções entrarem e a verificação de segurança passar", com um botão Cancelar.
- Se ainda sobrar algo para corrigir depois dessa criação, você vê "Ainda falta 1 item para corrigir antes de publicar" e pode corrigir de novo. Nada é publicado.
- Quando só restam sugestões, o cartão mostra "Estas correções são opcionais — você pode publicar agora" e um botão Publicar.
A publicação automática depois de "Corrigir e publicar" é esquecida se você recarregar a página, então ela nunca publica mais tarde de surpresa. Se isso acontecer, é só abrir Publicar de novo quando a criação terminar.
Alguns itens levam você a outro lugar em vez de oferecer uma correção. Por exemplo, Os pagamentos estão em modo de teste tem um link Conectar o Stripe.
Como corrigir os itens mais comuns
Chaves privadas no seu código
As chaves ficam em Gerenciar → Segredos, nunca no código. Peça assim:
Tira todas as chaves de API do código. Faz o app ler essas chaves de configurações que ficam só no servidor e me diz quais eu preciso adicionar em Gerenciar → Segredos.
Depois, adicione cada chave em Gerenciar → Segredos. Veja Segredos e chaves de API.
Uma chave de que o seu app precisa não está salva
Adicione a chave que falta em Gerenciar → Segredos, ou conecte o serviço na página Conectores e confira se ele está ligado para este app em Gerenciar → Conectores. Veja Conectores.
Falta o login, ou dados privados aparecem sem login
Coloca login no meu app. Toda página que mostra meus dados privados ou as informações salvas das pessoas tem que ficar atrás do login, pra que cada pessoa logada veja só os próprios dados.
Se o app não precisa mais de contas, mude isso no seu plano. Veja Login de usuários.
Os dados das pessoas não estão protegidos
Use o botão Corrigir do item. Ele pede à IA que exija login naquela página ou naquele link de dados e que devolva só os dados da pessoa que fez login.
Um preço poderia ser alterado
Use Corrigir, ou peça: "Busca todos os preços no servidor a partir do produto e nunca confia num preço que vem do navegador." Veja Receba pagamentos.
Título provisório ou descrição faltando
Peça à IA que dê ao seu app um título e uma descrição de verdade. Você também pode defini-los na aba Dados do site da janela Publicar: eles são adicionados ao seu site no ar quando você publica, mas esta verificação lê o código do seu app, então ela continua aparecendo até que a IA adicione os textos ao próprio app. Se o seu título ainda for um texto provisório, como "Buildliy app", a publicação usa o nome do seu projeto no lugar (a menos que o projeto ainda tenha o nome automático), mas um título escrito por você fica melhor. Veja SEO e compartilhamento.
Links quebrados, descrições e rótulos faltando
Corrige os links internos quebrados, coloca um texto alternativo descritivo em toda imagem importante e dá um rótulo visível pra todo campo de formulário.
Notas da IA
Abaixo das verificações, a aba Lançamento pode mostrar Notas da IA, marcadas como Não verificado. São coisas que a IA sugeriu olhar enquanto criava o seu app. A Buildliy não verificou essas notas, e elas nunca podem impedir você de publicar.
Quando o seu app estiver no ar, a aba Lançamento também mostra uma linha como "Site no ar: funcionando · verificado há 5 minutos". Veja Hospedagem.
Veja também
Ainda com dúvida? Leia as Perguntas frequentes ou fale com a gente.