Primeiros passos
Pré-requisitos
| Requisito | Detalhes |
|---|---|
| Node.js 24.15+ | Baixe o Node.js se você ainda não tiver |
| npm | Já vem com o Node.js |
Instalação
npm install -g @tiendanube/cli
Verifique a instalação:
nuvemshop --version
tip
Você pode usar tanto tiendanube quanto nuvemshop — os dois comandos são idênticos.
Escolha seu fluxo de trabalho
O Nuvemshop CLI suporta duas formas de sincronizar arquivos de tema. Compare as funcionalidades e escolha a que melhor se adapta ao seu projeto:
| Funcionalidade | FTP (legado) | Fork |
|---|---|---|
| Baixar / Enviar / Monitorar | Sim | Sim |
| Gerenciamento de instalações | Não | Sim |
| Fork / Clone / Publicar | Não | Sim |
| URLs de pré-visualização | Não | Sim |
| Autenticação | Credenciais FTP | Bearer token |
| Suporte de temas | Todos os temas | Somente Ipanema |
| Fluxo de trabalho | Ideal para | Guia |
|---|---|---|
| Fork | Tema Ipanema — gerenciamento completo de instalações, autenticação via bearer token | Fork workflow |
| FTP (legado) | Temas legados com FTP aberto — sincronização simples de arquivos via FTP | Fluxo FTP (legado) |
danger
O Fork workflow está disponível apenas para o tema Ipanema, que ainda está em fase de rollout e pode não estar disponível para todas as lojas. Se a sua loja usa um tema legado com FTP aberto, use o Fluxo FTP (legado) — o fluxo de fork não se aplica a temas legados.