Como lançar seu primeiro aplicativo a partir do GitHub.
Conecte o GitHub, escolha um repositório, defina os recursos e um endereço e coloque tudo no ar em poucos minutos — com 3 dias de teste grátis para o seu primeiro aplicativo.
Os Aplicativos rodam o seu próprio código — um site, uma API, uma tarefa em segundo plano — direto do seu repositório Git. Você não escolhe servidor nem plano de hospedagem: escolhe um repositório, nós descobrimos como fazer o build e executá-lo, e cada push entra no ar sozinho.
Tudo acontece no novo painel (rivervo.com/panel) → Aplicativos → Novo aplicativo.
1. Conecte sua conta Git
O GitHub está sempre disponível. Clique em Conectar o GitHub: o GitHub pergunta onde instalar a Rivervo (na sua conta pessoal ou em uma organização) e quais repositórios ela pode ler. Nada é gravado nos seus repositórios.
Já instalou a Rivervo no GitHub antes? Use Já instalou no GitHub? Vincule.
O GitLab e o Bitbucket aparecem como botões extras acima da lista de repositórios onde estão disponíveis. A conexão funciona do mesmo jeito: você permite que a Rivervo leia seus repositórios e adicione um webhook para deploys automáticos. Seu código nunca é alterado.
2. Escolha o repositório
Pesquise seus repositórios, clique no que vai receber o deploy e depois escolha:
- Branch — o branch que entra no ar. Cada push para ele recebe deploy automático.
- Pasta do projeto — só para um repositório com vários projetos (um monorepo), por exemplo
apps/web. Deixe vazio quando o projeto estiver na raiz.
Clique em Continuar.
Ainda não tem repositório? Ou comece com um modelo cria um novo repositório na sua conta do GitHub a partir de um dos nossos modelos — Next.js, Laravel, Express, Flask ou um site estático. O código é seu, e você publica as mudanças com um push.
3. O que detectamos
Lemos o repositório e descobrimos como fazer o build e iniciá-lo. Você não escreve nenhuma configuração. Reconhecemos:
| Stack | O que procuramos |
|---|---|
| Node.js | Next.js, Nuxt, SvelteKit, Astro, Express, Fastify, Koa, Hono, NestJS; npm, yarn ou pnpm pelo arquivo de lock |
| PHP | Laravel, Symfony, Slim, CodeIgniter ou PHP puro (8.2–8.4) |
| Python | Django, Flask, FastAPI |
| Go | um go.mod na raiz |
| Sites estáticos | HTML puro ou um build de front-end: Vite (React, Vue, Svelte), Create React App, Angular, Gatsby, Docusaurus, VitePress, uma exportação estática de Next.js ou Nuxt |
Se o seu repositório tiver um Dockerfile próprio, fazemos o build com ele do jeito que está — essa também é a forma de rodar uma stack que não está na lista.
Você pode alterar depois os comandos detectados de instalação, build e inicialização em Configurações → Configurações de build. Observações para cada stack: Laravel, Node.js, Next.js e Nuxt, Python, sites estáticos.
4. Recursos e preço
Escolha quanto o seu aplicativo precisa com três controles deslizantes:
| Recurso | Preço | Faixa |
|---|---|---|
| Memória | R$ 34,76 por GB por mês | 256 MB, 512 MB e depois GB inteiros até 16 GB |
| CPU | R$ 23,17 por núcleo por mês | de 1 a 8 núcleos |
| Disco | 10 GB inclusos para cada GB de memória, depois R$ 0,87 por GB por mês | de 5 a 500 GB, de 5 em 5 GB |
Alguns exemplos:
| Memória | CPU | Disco | Por mês |
|---|---|---|---|
| 512 MB | 1 núcleo | 5 GB | R$ 40,55 |
| 1 GB | 1 núcleo | 10 GB | R$ 57,94 |
| 2 GB | 2 núcleos | 20 GB | R$ 115,87 |
| 4 GB | 2 núcleos | 60 GB | R$ 202,77 |
O painel mostra o total mensal enquanto você move os controles. Você pode alterar os recursos quando quiser depois; o aplicativo mantém seus dados. Todo aplicativo também inclui 500 GB de tráfego por mês por projeto — veja Cobrança dos aplicativos.
5. O endereço
Escolha como o aplicativo pode ser acessado — nada vem selecionado de antemão:
- Endereço público — aberto para a internet em um endereço grátis com HTTPS,
https://<name>.rivervo.app. Você pode conectar seu próprio domínio depois do lançamento — veja Domínios próprios. - Somente interno — sem endereço na internet; só os outros serviços do aplicativo o acessam. Ideal para uma API ou um backend chamado por outro serviço do aplicativo — veja Comunicação entre serviços.
Escolha o nome (letras latinas minúsculas, números e hífens, de 3 a 42 caracteres); o painel diz na hora se ele está livre. Você pode trocar entre as duas opções depois em Configurações → Endereço público.
6. Lançamento — e o teste grátis
Clique em Lançar e cadastre seu cartão. Seu primeiro aplicativo vem com 3 dias de teste grátis: o cartão não é cobrado nesses 3 dias, e o primeiro pagamento é feito quando o teste termina. Depois disso, o aplicativo é cobrado mensalmente pelo preço mostrado.
O teste é oferecido uma única vez por conta — para o primeiro aplicativo que você lançar.
7. O primeiro deploy
Depois do lançamento, o painel mostra cada etapa ao vivo: busca do código, verificação de segurança, build, inicialização e ativação do endereço. Normalmente leva alguns minutos. Antes de cada versão, verificamos se há código malicioso escondido; um projeto que o contenha não passa por build nem é executado.
Quando o deploy termina, Abrir leva você ao seu aplicativo no ar (para um aplicativo com endereço público).
Se o lançamento não terminar, o painel mostra a etapa e o log. Corrija a causa no seu código ou nas Variáveis e clique em Tentar de novo — nada mais é cobrado. Explicar este erro traz uma explicação curta do log e de como corrigir o problema (veja Ferramentas para desenvolvedores).