Técnico

Comece por abrir a página de estado do build — cada etapa tem um botão Logs que mostra onde falhou. A maior parte das falhas cai em três categorias: um soluço transitório da infraestrutura (clique em Retry), um erro de código que a IA pode corrigir sozinha (inicie um chat com "o build falhou, o erro é: …" e cole a linha do log) ou um problema num serviço conectado (Stripe, GitHub, o seu fornecedor de domínio). Se nenhum se aplica, contacte o suporte com o ID do projeto — podemos re-executar o pipeline manualmente.

Três causas comuns. (1) O DNS ainda não propagou totalmente — espere 5–15 minutos e faça hard refresh. (2) O navegador colocou em cache um asset antigo — abra numa janela anónima. (3) O output do primeiro build era sintaticamente válido mas logicamente errado — inicie um chat com "a home aparece em branco quando abro" e a IA corrige no próximo refinamento. A consola do navegador (F12 → Console) costuma mostrar o erro real.

Os builds correm numa fila partilhada. Free e Starter têm prioridade standard e podem esperar alguns minutos nas horas de pico; Pro e Business têm slots prioritários e quase nunca esperam. Se o seu build está há mais de 10 minutos em fila, isso não é normal — atualize a página (o estado passa por websocket e às vezes a ligação cai) e se mesmo assim não arrancar, contacte o suporte com o ID do projeto.

Sim. Abra o projeto, clique no menu de três pontos e escolha "Redeploy". O código fica exatamente igual — mas as novas variáveis de ambiente são lidas, os artefactos de build expirados são reconstruídos e as melhorias do lado da plataforma (patches de segurança no runtime, por exemplo) são aplicadas. Um redeploy sem alterações custa 1 crédito e termina em menos de um minuto.

Na AWS, por defeito na região us-east-1. Os assets estáticos são servidos pela rede global de edge da CloudFront, por isso os seus visitantes batem num PoP próximo independentemente de onde esteja a origem. O rendering server-side corre no AWS Lambda, a base de dados do projeto está em Amazon RDS Postgres e os ficheiros enviados ficam em S3. A residência de dados na UE está na roadmap mas ainda não está disponível — avise o suporte se for um requisito rígido para si.

Sim — o código do projeto vive num repositório GitHub que criámos em seu nome. Abra Definições do projeto → Repositório para ver o URL e dar acesso de escrita à sua conta. Clonar, fazer fork ou mover para outra org GitHub funciona como em qualquer repo. Idem para a base de dados (expomos uma connection string Postgres em Definições → Base de dados → Exportar). Mantém a propriedade do código e dos dados; o FloopFloop é uma camada de deploy + IA por cima.

No Pro ou superior: abra o projeto, vá a Definições → Domínios, clique em "Adicionar domínio" e introduza o seu domínio (raiz ou subdomínio). O FloopFloop mostra dois registos DNS para adicionar no registrar — um CNAME (ou A/ALIAS para um domínio apex) e um TXT para verificação. Quando os dois forem detetados, o SSL é provisionado automaticamente e o domínio fica online, normalmente em 5–30 minutos. O Free e o Starter não suportam domínios personalizados; é preciso atualizar o plano.

A maioria dos problemas é do lado do DNS. Verifique que o registo CNAME (ou A/ALIAS) existe, aponta para o valor que o FloopFloop mostrou e não está atrás de um proxy que bloqueie a nossa verificação (a "nuvem laranja" da Cloudflare deve estar desligada até a verificação terminar — pode ligá-la depois). Use `dig o-seu-dominio.com +short` num terminal para ver o que o mundo vê. A verificação costuma demorar menos de 15 minutos; se após uma hora continuar como "Pendente", contacte o suporte com o domínio.

Todos os secrets são cifrados em repouso com AES-256 no AWS Secrets Manager e só são decifrados em tempo de pedido dentro do runtime do seu projeto — nunca são escritos em disco nem nos logs de build. Depois de guardar um secret, o valor é write-only: pode atualizá-lo ou apagá-lo, mas não voltar a lê-lo a partir do painel. A equipa do FloopFloop não tem acesso aos valores em texto claro; só vemos o nome da chave e os metadados de auditoria.

Sim. Abra Definições → Secrets, encontre a entrada, clique em "Rodar" e cole o novo valor. Em cerca de 30 segundos o runtime em execução começa a ler o novo valor (fazemos hot-reload dos secrets sem reiniciar a função). Se o secret fizer parte de uma config de build-time (raro), aparece um banner a pedir redeploy — cerca de um minuto e 1 crédito.

Diga à IA no chat: "adiciona um cron que corre todos os dias às 9h e me envia por email um resumo dos novos registos". A IA gera uma rota `/api/cron/<nome>` no seu código, regista o schedule (expressão cron ou intervalo) e em cada redeploy o nosso scheduler mantém o registo sincronizado. Cada invocação chega com um bearer token com escopo ao projeto, por isso só o nosso scheduler pode dispará-la. As execuções e logs estão em Definições → Agendamentos.

Em macOS e Linux: `curl -fsSL https://floop.tech/install.sh | sh`. Em Windows: descarregue o último instalador da página de Releases no GitHub do repo floop-cli, ou use `winget install FloopFloopAI.floop`. Depois de instalado, execute `floop login` — abre um navegador para autorizar este dispositivo. A partir daí, `floop new`, `floop refine`, `floop deploy` e os restantes comandos funcionam sem mais configuração.

Um token de CLI é a credencial que o `floop login` escreve na sua config local — identifica o utilizador humano num dispositivo específico, e pode revogá-lo em /account/devices quando deixar de usar um portátil. Uma API key é para acesso não assistido a partir de scripts, CI ou apps de terceiros — cria-as em /account/api-keys, pode dar-lhes scope por projeto se quiser, e roda-as quando quiser. Ambas falam com a mesma superfície `/api/v1/*`, mas só as API keys devem entrar em automações.

Sim — os oito SDK oficiais (Node, Python, Go, Rust, Ruby, PHP, Swift, Kotlin) embrulham todos a mesma superfície `/api/v1/*` e expõem nomes de método correspondentes. Quando adicionamos um endpoint, espelhamos em todos os SDK na mesma release. O servidor MCP (`@floopfloop/mcp`) reexpõe o SDK Node a agentes LLM e recebe o novo método automaticamente. Se notar uma lacuna, é um bug — abra uma issue no repositório do SDK em questão.