Do zero à aplicação publicada: crie um app com GitHub e NebuaCloud

Você não precisa saber programar para começar uma aplicação. Neste guia, transformamos uma ideia escrita em texto simples numa aplicação publicada na internet.

O caminho é este:

Ideia → Descrição em texto → Proposta de mudança → Versão de teste → Aprovação → Publicação → Domínio próprio

O GitHub guarda os arquivos do projeto e o histórico de tudo o que muda. A NebuaCloud usa esse projeto para gerar a aplicação a partir da sua descrição, monta uma proposta de mudança e cria uma versão de teste. A aprovação final continua sendo sua, feita no GitHub.

Sobre a disponibilidade atual: este é o fluxo do Assistente de Repositório com IA. Num projeto vazio, ele pode gerar uma aplicação completa. A publicação automática depois da aprovação depende de uma configuração de Integração Git; sem ela, existe um botão para publicar manualmente. A tela atual não mostra instruções de DNS nem o estado do certificado de segurança — por isso este guia trata esses pontos como verificações manuais.

O que você precisa antes de começar

• Um e-mail para criar e confirmar a conta no GitHub.
• Uma conta GitHub com permissão para criar ou alterar um projeto e para aprovar mudanças.
• Uma conta NebuaCloud com sessão iniciada e uma organização ativa, com a funcionalidade de propostas com IA habilitada.
• Um projeto (repositório) no GitHub — pode estar vazio ou já conter uma aplicação.
• Um domínio próprio, apenas para a etapa final, com acesso ao painel onde ele é configurado.

Nesta tela não há campos técnicos para escolher servidor ou modelo de IA. A NebuaCloud resolve tudo isso automaticamente.

Conceitos rápidos, sem jargão

• GitHub: serviço onde ficam os arquivos e o histórico de um projeto.
• Repositório: a pasta online de um projeto, com os arquivos e as versões anteriores.
• Proposta de mudança (Pull Request): um pedido para aplicar uma alteração, que permite revisar antes de publicar.
• Aprovação (merge): a confirmação de que a proposta aprovada passa a valer.
• Versão de teste (preview): uma cópia temporária para experimentar uma mudança antes de ela virar a versão real.
• Publicação (deploy): o processo de colocar a aplicação no ar.

Uma comparação: a versão principal é o livro já publicado. Uma proposta de mudança é a revisão editorial de um capítulo. A aprovação é a decisão de atualizar o livro.

1. Crie sua conta e seu projeto no GitHub

1. Acesse github.com e crie uma conta com e-mail, senha e nome de usuário.
2. Confirme o e-mail quando solicitado.
3. Ative a verificação em duas etapas (2FA) para proteger a conta.

Agora crie o projeto:

1. No GitHub, abra o menu + e escolha New repository.
2. Escolha quem será dono do projeto (sua conta ou uma organização).
3. Dê um nome simples, por exemplo lista-de-tarefas.
4. Escolha se ele será público ou privado, e clique em Create repository.

Um projeto vazio funciona: a NebuaCloud cria os arquivos iniciais. Se você adicionar um arquivo de descrição (README), a IA usa esse conteúdo como contexto.

2. Conecte o GitHub à NebuaCloud

Entre na NebuaCloud, confirme que está na organização correta e abra Assistente de Repositório com IA no menu lateral.

1. Na coluna Repositórios, mantenha GitHub selecionado.
2. Se aparecer Desconectado, clique em Conectar GitHub.
3. Uma janela do GitHub abre. Entre na sua conta e autorize a conexão.
4. Volte à NebuaCloud e confirme o selo Conectado, escolhendo a conta ou organização GitHub.

Essa autorização dá à NebuaCloud uma permissão limitada para acessar apenas os projetos escolhidos. A sua senha do GitHub nunca é compartilhada.

Se a conexão não funcionar

• A janela não abriu: libere pop-ups para a NebuaCloud e tente de novo.
• A conta não aparece conectada: clique em Atualizar. Se persistir, reconecte o GitHub.
• O projeto não aparece: confirme no GitHub que você tem acesso a ele e que a autorização inclui aquela organização.
• A NebuaCloud pede mais permissão: siga o botão de concessão de permissão que aparece e conclua no GitHub.

3. Descreva a aplicação que você quer

Ainda em Assistente de Repositório com IA:

1. Escolha a conta GitHub conectada e clique no projeto que você criou.
2. No campo Descreva a alteração, escreva o que a aplicação deve fazer.
3. Clique em Gerar alterações e aguarde. A página acompanha o progresso.

Use este exemplo:

Crie uma aplicação web de lista de tarefas. O usuário deve conseguir adicionar, concluir e remover tarefas. Use um visual moderno, responsivo e com modo claro e escuro.

Como escrever uma boa descrição

Explique o resultado que você espera:

• O objetivo da aplicação.
• As ações que o usuário precisa conseguir fazer.
• O estilo visual desejado.
• Se precisa funcionar bem no celular.
• Regras importantes, como não remover algo que já existe.

Descrição fraca: "Faça um app legal."

Descrição melhor: "Crie uma lista de tarefas. Permita adicionar, concluir e remover tarefas. Mostre uma mensagem quando a lista estiver vazia. O layout deve funcionar bem no celular, ter modo claro e escuro e botões grandes e fáceis de tocar."

Depois de escolher o projeto, descreva a mudança no campo principal; o cartão mostra a proposta e a versão de teste separadamente.

4. Entenda a proposta criada automaticamente

A NebuaCloud gera os arquivos e cria uma proposta de mudança no GitHub. Quando termina, a página mostra:

• Um link Abrir pull request.
• O resumo da alteração.
• Os arquivos modificados.
• Notas curtas para a revisão.

Abra o link para ler a proposta no GitHub. É lá que ficam a comparação dos arquivos, os comentários, as aprovações e a decisão final. A NebuaCloud não aprova nada no seu lugar.

Se algo falhar, o item fica marcado como failed com uma mensagem. As causas mais comuns são falta de acesso ao projeto ou falha ao preparar a proposta.

No GitHub, use as abas de arquivos alterados e verificações para revisar antes de aprovar.

5. Teste a versão de demonstração

Junto com a proposta, a NebuaCloud prepara uma versão de teste. Quando fica pronta, a página mostra Abrir pré-visualização ou um endereço.

Enquanto a versão de teste estiver sendo preparada, o status indica "em andamento". Só quando aparece pronto o endereço está disponível. Se aparecer um erro, abra Ver pipeline para ver os detalhes.

A versão de teste é temporária. Não a trate como definitiva e não compartilhe o endereço como se fosse o endereço final.

O que verificar quando o endereço estiver pronto

• A página abre sem erro.
• Os links e a navegação funcionam.
• Os botões fazem o que você pediu.
• Os formulários mostram erros de forma compreensível.
• A tela continua utilizável na largura de um celular.
• As funcionalidades pedidas realmente existem.

6. Aprove ou peça alterações

Abra a proposta no GitHub. A decisão acontece lá.

Caminho A: a aplicação está correta

1. Leia o resumo e veja os arquivos alterados.
2. Confira as verificações exigidas pelo seu projeto, se houver.
3. Teste a versão de demonstração mais uma vez.
4. Clique em Approve e depois em Merge pull request, confirmando a aprovação.

O GitHub pode exigir revisão ou verificações antes de liberar. Veja os guias de revisão e aprovação.

Caminho B: a aplicação precisa de ajustes

1. Não aprove ainda.
2. No GitHub, escreva um comentário claro ou use Request changes.
3. Volte ao Assistente de Repositório com IA, selecione o mesmo projeto e envie uma nova descrição específica.
4. Teste a nova versão de demonstração e revise a nova proposta antes de aprovar.

Exemplo:

O formulário funciona, mas no celular o botão "Adicionar tarefa" ultrapassa a largura da tela. Corrija o layout no celular sem mudar as funcionalidades existentes.

Cada novo pedido cria uma proposta nova; ele não altera a anterior. Use o GitHub para relacionar ou fechar a proposta antiga.

7. Publique a versão aprovada

A aprovação atualiza a versão principal no GitHub. Para levá-la ao ar pela NebuaCloud, configure a Integração Git da aplicação ou publique manualmente.

Publicação automática

Faça isto antes da aprovação se quiser que cada mudança aprovada vá ao ar sozinha:

1. No painel, abra Projetos e selecione a aplicação.
2. No menu Ações, escolha Integração Git.
3. Confirme a aplicação, escolha GitHub, a conta, o projeto e a versão principal.
4. Ative Implantar automaticamente por push e clique em Salvar integração.
5. A NebuaCloud mostra um endereço e um código de segurança para ligar o GitHub à publicação automática. A própria página guia essa configuração.

Com isso pronto, aprovar uma mudança inicia a publicação. O histórico de publicações fica nessa mesma página. Se preferir publicar sob demanda, use Implantação de gatilho.

A publicação real não usa o endereço da versão de teste. Ela monta a versão principal e a coloca no ar no ambiente da aplicação.

Ambiente	Para que serve
Versão de teste	Experimentar a proposta antes da aprovação.
Produção	Executar a versão principal depois de uma publicação bem-sucedida.

Considere a publicação concluída apenas quando o histórico indicar sucesso e o endereço da aplicação abrir. Aprovar a mudança, por si só, não prova que ela está no ar.

Ative a publicação automática apenas depois de conferir a aplicação, o projeto e a versão selecionados.

8. Adicione um domínio próprio

Depois de confirmar a aplicação no ar, abra-a em Projetos:

1. Entre no detalhe da aplicação em produção.
2. Abra Ações e escolha Editar domínio.
3. Informe o endereço desejado, por exemplo app.minhaempresa.com.
4. Clique em Salvar alterações.

Ao salvar, a NebuaCloud passa a aceitar esse endereço e prepara automaticamente a segurança (HTTPS) para ele. A tela não mostra o destino de DNS a configurar nem o estado do certificado.

Por isso, não copie configurações de DNS genéricas deste artigo. Use, no painel do seu domínio, os valores de destino que a equipe da NebuaCloud fornece para o seu ambiente.

Termos de DNS em linguagem simples

• Domínio: o endereço principal, como minhaempresa.com.
• Subdomínio: uma parte antes do domínio, como app.minhaempresa.com.
• DNS: a "agenda" da internet que liga um nome a um destino.
• HTTPS: a versão protegida de um site, indicada pelo cadeado no navegador.
• Certificado de segurança: a credencial que o HTTPS usa para proteger a conexão.

Como confirmar o domínio

1. Configure no painel do domínio os destinos fornecidos pela NebuaCloud e aguarde a propagação (o tempo varia).
2. Atualize o detalhe da aplicação e confirme que não há aviso de DNS.
3. Abra https://seu-dominio numa janela anônima.
4. Confirme que a aplicação abre, que o cadeado de HTTPS aparece e que o endereço não volta para o temporário.

Se o domínio foi salvo mas não abre, confira os destinos de DNS com a equipe da NebuaCloud e procure suporte se o HTTPS continuar indisponível depois da propagação.

O campo Domínio define o endereço público da aplicação; salve apenas depois de decidir qual endereço será usado.

9. Checklist final

• A conta GitHub está conectada à NebuaCloud.
• O projeto foi criado ou selecionado.
• A descrição gerou uma proposta revisável.
• A proposta de mudança foi criada.
• A versão de demonstração foi testada.
• A mudança foi aprovada no GitHub.
• A Integração Git foi configurada, ou a publicação foi disparada manualmente.
• A publicação terminou com sucesso e o endereço abre.
• O domínio foi configurado só com os destinos de DNS confirmados para o ambiente.
• O HTTPS foi verificado no navegador.
• A aplicação foi testada no computador e no celular.

Solução de problemas

GitHub não aparece conectado: verifique se o pop-up foi bloqueado, conclua a autorização no GitHub e clique em Atualizar. Se persistir, reconecte.

A proposta não foi criada: leia a mensagem no item marcado como failed. Confirme que o projeto existe e que a conexão tem permissão para escrever nele e criar propostas.

A versão de teste continua "em andamento": aguarde a atualização. Se aparecer Ver pipeline, abra para ver os detalhes.

A aplicação retorna erro ou não abre: confirme que a publicação terminou e que você abriu o endereço de produção, não o de teste. Veja o histórico em Integração Git.

O domínio não foi validado: confirme no painel do domínio que ele usa os destinos corretos do seu ambiente NebuaCloud. Depois da propagação, teste em https://. Se continuar com erro, procure suporte com o nome da aplicação e o endereço — sem incluir senhas ou códigos.

Conclusão

Você começou com uma ideia e terminou com um processo organizado: os arquivos guardados no GitHub, uma proposta revisável, uma versão de teste e uma publicação controlada.

O domínio próprio fecha a experiência para o público, mas deve ser configurado só com os dados de DNS confirmados para o seu ambiente. Crie seu primeiro projeto, descreva a aplicação que quer construir e use a versão de teste para revisar antes de publicar.

Palavras-chave: criar aplicação com IA, GitHub para iniciantes, proposta de mudança, versão de teste, publicação, domínio personalizado, NebuaCloud.