Skip to main content

Criando um app

Duas formas:
  • Peça à IA - descreva o que você quer em uma thread e a IA constrói
  • Botão Novo app - clique em + na barra lateral Drive e escolha Novo app
A IA escolhe um template inicial baseado no que você pede:

Um app, uma branch

Cada app é um único checkout git em main. Não há rascunhos separados, sem troca de branch, sem etapa de merge. Cada edição vai para main como um commit; publicar é apenas “implantar o main atual”.

O ciclo de construção

  1. A IA escreve código diretamente em main
  2. A IA inicia o servidor de desenvolvimento. Você vê uma visualização ao vivo.
  3. Você itera por chat: “mova o gráfico para a barra lateral”, “adicione um tema escuro”
  4. O servidor de desenvolvimento recarrega automaticamente após cada edição
  5. Quando pronto, publique

Publicando

Publicar implanta o commit main atual. Não há uma branch de produção separada — o commit publicado mais recentemente em main é o que está ao vivo. Quando você publica no catálogo para outros instalarem, seu app recebe um token de identidade do usuário no lançamento, uma chave de instalação para seu backend e webhooks de instalação/desinstalação. Veja Publicando.

Cache, atualizações e offline

Desktop e mobile apenas abrem a URL do seu app em uma visualização normal do navegador. Eles não limpam caches do navegador, forçam carregamentos apenas de rede ou escolhem uma política de cache diferente para apps públicos vs privados. Seu app web controla o cache:
  • Headers HTTP Cache-Control para documentos e assets
  • Setup opcional de service worker / PWA (templates incluem vite-plugin-pwa com auto-atualização)
  • Se uma nova build é ativada imediatamente, recarrega uma vez ou aguarda a próxima abertura
  • Fallback offline para a build ativada mais recentemente
Quando Kazzle vê uma nova versão publicada para uma aba de app aberta, ele pede ao service worker registrado para verificar uma atualização (registration.update()). Apps sem um service worker ignoram essa verificação e continuam usando seus próprios headers de cache HTTP. Apps publicados podem, portanto, abrir instantaneamente do cache, pegar uma nova build sem um hard refresh e manter a build mais recente disponível offline.

Implantando

Após publicar, implante para obter uma URL ao vivo:
  • Apps remotos implantam na nuvem Kazzle e recebem uma URL pública
  • Apps locais instalam no seu computador. A UI carrega diretamente e a parte de processo executa um servidor de desenvolvimento.

Apps em tempo real

Para apps que precisam de leituras locais instantâneas e suporte offline, a IA:
  1. Cria um banco de dados
  2. Ativa sincronização em tempo real
  3. Constrói um app de duas partes: UI (React + cliente de sincronização) e Process (endpoint de token + upload de sincronização)
  4. Conecta credenciais através do vault
Veja Sincronização em tempo real para saber como funciona.

Landing pages

Landing pages são apps apenas de UI. Sem backend, sem banco de dados. Descreva a página e a IA constrói, implanta e oferece uma URL ao vivo. Para usar um domínio personalizado, aponte seu domínio ou subdomínio para a URL do app implantado.