Docs do ChanTan StudioComo publicar seu app no ChanTan Studio
Coloque seu site no ar em um endereço de verdade em 1 a 4 minutos: escolha seu endereço chantan.one grátis, publique e suba as próximas edições com “Atualizar”.
Enquanto você constrói, seu app só existe na sua pré-visualização privada. Publicar é copiar o app para a internet pública, em um endereço web de verdade — qualquer pessoa abre no navegador, sem login e sem precisar de conta no ChanTan.
Pense na Doces da Ana, a confeitaria de brigadeiros em Belo Horizonte: enquanto o site não é publicado, o cardápio e o formulário de encomendas só existem na tela dela. Depois de publicar, qualquer cliente abre pelo celular.
Bom saber antes de começar:
- Publicar leva de 1 a 4 minutos. Você pode fechar a janela — o processo continua em segundo plano.
- O endereço é grátis para sempre, e o HTTPS (o cadeado) é configurado para você automaticamente. O que custa é manter o site no ar: uma pequena cobrança mensal em créditos, e só depois do primeiro mês.
- A hospedagem é grátis no primeiro mês de cada app publicado. Depois disso entra uma pequena cobrança mensal em créditos — veja a hospedagem ChanTan Cloud para saber o valor e se essa cobrança já está valendo.
- O link da pré-visualização não serve para compartilhar seu site. Ele é privado, temporário e acaba dormindo. O endereço publicado é o endereço real e permanente.
1. Aperte “Publicar”
O botão “Publicar” é o último item do cabeçalho do seu projeto (a dica diz “Publique seu app na web”). No celular, é o ícone redondo de foguete no fim da linha do cabeçalho.
Se ele estiver apagado, a IA ainda está trabalhando — a dica mostra “Só um instante — você pode publicar assim que a geração terminar”. Espere ela terminar.
2. Escolha “Endereço grátis”
Abre uma janela: “Onde as pessoas vão visitar seu site?”, com três cards.
| Card | Selo | O que você ganha |
|---|---|---|
| “Endereço grátis” | “GRÁTIS · MAIS RÁPIDO” | meu-app.chantan.one |
| “Já tenho um domínio” | — | Usar um domínio que já é seu |
| “Comprar domínio” | “A PARTIR DE US$ 1/ANO” | Ter seusite.com — a gente configura tudo |
⚠️ “A PARTIR DE US$ 1/ANO” é um selo, não um preço. É a extensão mais barata que já existiu, não o que o seu nome vai custar. O preço que aparece no resultado da pesquisa é o real, e a renovação custa mais do que o primeiro ano — veja renovação e preços de domínios.
Aperte “Endereço grátis”. Essas opções não se excluem: seu endereço grátis é sempre criado primeiro e continua funcionando para sempre; um domínio próprio é conectado por cima dele, mais tarde.
3. Escolha o nome do seu endereço
Tocar em “Endereço grátis” ainda não publica nada — abre a tela “Escolha seu endereço grátis”, já preenchida com o nome do seu projeto.
⚠️ “Escolha com cuidado — seu endereço web não poderá ser alterado depois.” Um endereço por projeto, para sempre. Se mais tarde você quiser outro endereço, conecte um domínio próprio — esse é o caminho certo para isso.
As regras do nome:
| Regra | Valor |
|---|---|
| Tamanho | 3 a 30 caracteres |
| Permitido | letras minúsculas, números e hífens |
| Deve começar e terminar com | uma letra ou um número — nunca com hífen |
| Maiúsculas, espaços, acentos | são limpos automaticamente enquanto você digita |
| Bloqueados | cerca de 45 nomes reservados, como www, app, admin, api, mail, support, blog, dashboard, login |
O campo verifica enquanto você digita. Um check verde com “Disponível!” significa que está tudo certo — docesdaana é seu.
Se aparecer um X vermelho, a mensagem diz exatamente o motivo:
| Mensagem | O que fazer |
|---|---|
| “Use pelo menos 3 caracteres.” | Deixe o nome mais longo |
| “Não pode começar nem terminar com hífen.” | Mova o hífen para o meio |
| “Esse nome é reservado.” | Escolha outra palavra |
| “Use de 3 a 30 letras, números e hífens.” | Tire tudo o que não for letra, número ou hífen |
| “Esse endereço já está em uso.” | Alguém já pegou — acrescente uma palavra ou um hífen |
| “Não deu para verificar esse endereço agora — continue digitando ou tente de novo.” | A própria verificação falhou. Ela responde “indisponível” de propósito, para que um nome nunca seja entregue duas vezes |
4. Aperte “Publicar meu app”
Você vai ver “Publicando seu app…” com um aviso honesto: “Isso costuma levar de 1 a 4 minutos. Pode fechar esta janela — a gente continua em segundo plano.”
Cinco etapas rodam em ordem:
- “Preparando seus arquivos”
- “Acordando o construtor”
- “Enviando suas últimas alterações”
- “Construindo e enviando seu app”
- “Indo ao ar”
Um cronômetro corre embaixo e, depois de 3 minutos, ele acrescenta “Ainda trabalhando — apps maiores levam um pouco mais de tempo.” Fechar a janela não cancela nada.
5. Abra seu site no ar
Quando termina, aparece “🎉 Seu app está no ar!” — com confete, seu endereço completo em uma caixa para copiar e um botão grande “Visitar seu site”.
✅ Pronto! Seu app está no ar em https://seu-nome.chantan.one. Qualquer pessoa com o link abre no navegador — os visitantes não precisam de conta no ChanTan — e o cadeado (HTTPS) já está lá.
Guarde a frase mais importante dessa tela:
“As próximas edições ficam privadas até você apertar Atualizar.”
Como subir suas próximas edições
Mensagens no chat, mudanças feitas com clique, páginas novas, fotos novas — tudo fica privado até você publicar de novo.
- Aperte o botão do cabeçalho, que agora diz “Atualizar” com um pontinho âmbar.
- A janela “Seu app publicado” mostra seu endereço no ar (com “Copiar” e “Visitar”) e uma linha de status: um ponto verde com “No ar · publicado {ago}”, ou um ponto âmbar com “Você tem alterações que ainda não estão no ar.”
- Aperte “Atualizar site”.
Se o botão estiver apagado, nada mudou desde a última publicação — a dica diz “Seu site no ar está atualizado”. Qualquer diferença conta, até a troca de uma única foto.
Atualizar nunca derruba seu site. A versão nova é enviada inteira e a troca acontece em um único instante, no fim. Se a construção falhar antes disso, o site antigo continua atendendo — a tela de erro promete exatamente isso: “O site que está no ar continua intacto.” Os visitantes veem a versão nova assim que recarregam a página.
Uma lista recolhível “Versões anteriores” mostra suas últimas publicações, com horário e status.
⚠️ Essa lista é só histórico — não existe botão de “restaurar esta versão”. Para mudar o que está no ar, edite seu app (ou use Desfazer no chat) e publique de novo.
Como tirar seu site do ar
Janela de publicação → “Mais opções” → “Tirar meu site do ar” (em vermelho) → confirmar.
| Pergunta | Resposta |
|---|---|
| Eu continuo com meu endereço? | Sim — ele fica reservado para este projeto para sempre |
| O que os visitantes veem? | Uma página simples, em inglês: “Nothing here yet — There is no app published at this address.” (nada por aqui ainda — não há app publicado neste endereço). Os buscadores recebem a instrução de não listar a página |
| Posso colocar de volta? | Sim — aperte Publicar de novo; o site é reconstruído no mesmo endereço |
| Os arquivos do meu projeto são apagados? | Não. Só a cópia pública sai do ar — seu projeto, chat, arquivos e dados continuam intactos |
| É instantâneo? | Não — republicar roda a construção completa de novo, ou seja, 1 a 4 minutos |
| E meu domínio próprio? | Continua conectado, mas sem nada para mostrar até você publicar de novo |
Tirar um site do ar também interrompe a cobrança de hospedagem — a partir desse momento o app deixa de contar como hospedado.
Se a publicação falhar
Todo erro de publicação mostra a mesma frase tranquilizadora — “O site que está no ar continua intacto.” —, um botão “Tentar de novo” e uma seção “Detalhes técnicos” que você pode abrir. Se a publicação deu certo mas o site no ar está estranho, o problema é outro — veja problemas no site publicado.
As mensagens do construtor ainda chegam em inglês (só a última da tabela já aparece em português); aqui vai cada uma com o que significa e o que fazer:
| Mensagem | O que fazer |
|---|---|
| “This project has no files to publish yet — build something first.” (ainda não há arquivos para publicar) | Peça antes à IA, no chat, para construir seu app |
| “Could not start the builder…” / “The builder took too long to start. Try again.” (o construtor não ligou) | Problema passageiro na máquina de construção — tente de novo |
| “Could not sync your latest files… Try again.” / “The build could not start… Try again.” | Passageiro — tente de novo |
| “The app failed to build. Check the technical details and fix the error, or try again.” (seu app tem um erro de verdade) | Abra “Detalhes técnicos”, descreva o erro no chat e peça à IA para corrigir |
| “Publishing took too long and was stopped. Try again.” (passou do tempo limite) | Tente de novo |
| “Publishing was interrupted. Try again.” (a publicação caiu e já foi reiniciada para você) | Tente de novo |
| “The build produced no publishable files.” / “The build produced no index.html.” (não saiu um site) | Peça à IA para verificar seu app |
| “This app is too large to publish (200 MB limit).” (o app está pesado demais) | Remova ou comprima fotos e vídeos grandes |
| “This file contains <secret>. Secret keys must never ship in a published app…” (há uma chave secreta no código) | Peça à IA para mover essa chave para o lado do servidor e usar a chave pública no navegador |
| “A publicação falhou — abra Publicar para tentar de novo” | A janela foi fechada. Reabra Publicar e tente de novo |
Limites, com honestidade
| Limite | Valor |
|---|---|
| Arquivos em um app publicado | 2.000 |
| Um único arquivo | 25 MB |
| O app inteiro | 200 MB |
Uma chave privada nunca pode ser publicada. Se uma for encontrada, a publicação é recusada com uma explicação. Essa proteção não pode ser desligada — ela existe para proteger você, porque um app publicado pode ser lido por qualquer pessoa.
Seu endereço grátis é seu desde o momento em que você o reserva. Antes de qualquer coisa ir ao ar, quem visita vê uma página simples, em inglês: “Nothing here yet — There is no app published at this address.” (nada por aqui ainda — não há app publicado neste endereço).