Primeiros passos

Problemas comuns ao gerar app

Problemas comuns ao gerar app

"Resposta cortada no meio"

A IA passou do limite de tokens. A plataforma detecta e bloqueia o save automaticamente — código quebrado não entra no banco.

Por trás dos panos: o creator faz continuation automática quando detecta stop_reason: "max_tokens". Até 4 continuations totais = ~320K tokens de output. Stream continua emitindo texto sem você perceber.

Quando esgota (raro — apps gigantes):

  • Você vê o aviso "Resposta cortada no meio"
  • App não é atualizado (último código bom preservado)
  • Sugestões: pedir edição menor, dividir em sub-apps, ou usar modo Discussão pra planejar antes

"Código incompleto" ao colar de IA externa

Você colou um código que a IA externa (ChatGPT, Claude.ai) cortou.

Detecção automática identifica padrões: regex sem fechar, string sem fechar, template literal aberto, etc. Aviso mostra exatamente onde:

> 87 |     const codeMatch = line.match(/^
     |                                   ^

Solução: volta no chat externo, pede pra continuar de onde parou, e cola o resultado completo.

"Save bloqueado: N problemas estruturais"

Preflight detectou problemas que impedem o save. Tipos:

  • Erro de compilação (JSX desbalanceado, sintaxe quebrada): clique "Pedir pra IA corrigir →"
  • Código truncado: se for sub-app vazio, clique "↺ Recarregar versão salva do banco"
  • Hooks fora do componente: indica linha — você pode corrigir manual no editor

"Auto-retry tentou corrigir mas não conseguiu"

O preflight retry usa 1-2 rodadas com a IA. Se ainda falhar, opções:

  1. Click "Pedir pra IA corrigir →" — manda pro chat com a lista de erros
  2. Edite o código manualmente no painel "Código"
  3. Use o botão "Polir UI ✨" no topbar — corrige problemas visuais (bg-primary sem text-primary-foreground, etc) em ~3s sem regenerar tudo

App vazio depois de gerar

Se você criou um sistema modular via wizard, os sub-apps começam vazios (placeholder).

Abra cada sub-app na sidebar → vai cair na tela "Sub-app vazio" com botão grande "Gerar com IA". O chat já vem com prompt sugerido usando as tabelas compartilhadas — só revisar e enviar.

"Detectei N problemas estruturais — corrigindo..."

A geração pode disparar 1 retry quando a IA gera código com risco de:

  • Leak cross-tenant: queries em tabelas privadas sem WHERE owner_id =
  • Credencial hardcoded: API keys, senhas direto no código
  • Coluna sensível em texto puro: password, cvv

Quando dispara, você vê o aviso e a IA regenera (~30s). Warnings cosméticos (cores, contraste) não disparam retry — viram tarefa do botão "Polir UI".

Erro de banco: "Falha ao criar sistema"

Quando rola UNIQUE violation no slug (raro): a plataforma agora gera variantes automaticamente (crm-1, crm-2). Se ainda assim falhar, recarregue e tente de novo.

Upload de vídeo

Aceita: mp4, webm, ogg, mov até 200MB. Streaming via Range request (player pula/seek funciona normal).

Se o app antigo (gerado antes do suporte a vídeo) bloqueia upload, peça no chat: "Aceite upload de vídeo (mp4, webm, ogg, mov) até 200MB — a plataforma agora suporta upload direto".

Próximos passos