Documentação

Tudo o que precisas para pôr um projecto no ar com o GoLive — do primeiro deploy à factura.

O primeiro deploy

Cria a conta em app.golive.ao, cria um projecto no dashboard e instala a CLI:

$ npm install -g @golive/cli
$ golive login
$ golive init          # liga a pasta actual a um projecto
$ golive deploy

No fim do deploy recebes o URL público do projecto — https://<slug>.golive.ao — já com SSL. Se a pasta tiver um golive.json (criado pelo init), não precisas de passar --project em mais nenhum comando.

O deploy para produção pede confirmação. Usa --yes para saltar (útil em CI) — o exit code é sempre ≠ 0 em falha.

A CLI

Todos os comandos aceitam --project <id> (ou usam o golive.json da pasta) e --json para output legível por máquinas.

Runtimes suportados

O runtime é detectado automaticamente a partir dos ficheiros do projecto — não há configuração:

Backends lêem a porta de process.env.PORT (Node) ou $PORT (Go).

GitHub connect

$ golive link --repo a-tua-org/loja-da-kia
✔ Repo ligado: a-tua-org/loja-da-kia@main
✔ Publicado: https://loja-da-kia.golive.ao

Depois de ligado, cada git push para a branch configurada dispara um deploy automático. Usa --no-deploy para ligar sem publicar já, e golive unlink para desligar.

Deploys e rollback

Cada deploy é imutável e fica no histórico. A activação é atómica — o tráfego muda para a versão nova de uma vez, sem downtime. Para voltar atrás:

$ golive deploys          # lista o histórico
$ golive rollback         # volta ao deploy anterior

O rollback também está disponível no dashboard, no separador Deploys do projecto.

Domínios próprios

No dashboard, abre Domínios, adiciona o teu (ex.: www.lojadakia.ao) e cria os registos DNS que aparecem no ecrã, no teu registrar:

O certificado SSL é emitido automaticamente depois da validação (minutos, dependendo da propagação do DNS). Domínios próprios exigem o plano pay-as-you-go.

Bases de dados

$ golive db create --engine neon     # Postgres · turso = SQLite
✔ Base de dados criada

No deploy seguinte, o backend recebe DATABASE_URL no ambiente — liga-te com o driver normal do teu stack. Um projecto tem uma base de dados; golive db info mostra os detalhes e golive db destroy apaga-a.

Variáveis de ambiente

$ golive env set STRIPE_KEY=sk_live_...
$ golive env ls
$ golive env pull        # escreve um .env local

As variáveis são injectadas no backend no próximo deploy. Também podes geri-las no dashboard, no separador Variáveis do projecto. Nomes seguem o padrão MAIUSCULAS_COM_UNDERSCORE.

Logs

golive logs segue o build e o runtime em directo (sai com Ctrl-C; --no-follow imprime e sai). No dashboard, o separador Logs mostra o mesmo stream.

Planos e facturação

Free

1 projecto estático com subdomínio *.golive.ao e SSL. Para experimentares e publicares o teu portfólio ou landing hoje.

Pay-as-you-go

Desbloqueia domínios próprios, backends e bases de dados. O uso (armazenamento, computação, tráfego, minutos de build) é medido durante o mês e facturado no dia 28, em Kwanzas, com factura fiscal (SAFT-AO) emitida automaticamente com o teu NIF.

• Carregar saldo — por Multicaixa Express (aprovas no telemóvel) ou referência bancária. O saldo abate na factura automaticamente; não há débito automático em cartão.
• Sem saldo no dia 28? Tens até ao dia 01 para carregar. Depois disso o serviço é pausado (os dados ficam guardados) e retoma no momento em que o saldo entra.
• Limite de gastos — define um tecto mensal em Kz na Faturação; ao atingi-lo, a plataforma suspende os projectos sozinha.

Activar o pay-as-you-go exige NIF (para a factura fiscal). Não é preciso cartão de crédito em nenhum momento.

Limites

Precisas de mais? Escreve-nos: suporte via email.