Entrar
Documentação

Sistema de temas

Editor local

Baixe o tema, edite no seu computador e envie as alterações.

Com o CLI promisse, você edita um tema na IDE que preferir, como o VS Code, e usa Git se quiser. O CLI não tem dependências e precisa do Node.js 20.9 ou mais recente.

Conectar um tema#

  1. Abra a opção de edição local#

    Em Templates, na Biblioteca de temas, abra o menu do tema e escolha Editar localmente.

  2. Gere o token#

    Gere o token e copie os comandos.

  3. Conecte uma pasta vazia#

    Abra o terminal em uma pasta vazia e rode:

    Terminal
    promisse login pmt_seu_token

    Se o painel mostrar um endereço de API, o comando vem pronto com --api.

  4. Baixe os arquivos#

    Terminal
    promisse pull

Editar e enviar#

Edite os arquivos e envie quando quiser:

Terminal
promisse push

O envio é tudo ou nada: se um arquivo for recusado, nenhum é gravado. O CLI mostra os problemas por arquivo.

Comandos#

Comando O que faz
promisse login <token> [--api https://...] Conecta a pasta atual a um tema.
promisse pull Baixa os arquivos do tema.
promisse push Envia as alterações.
promisse push --force Envia mesmo que o tema tenha mudado no servidor.

Como o CLI trabalha#

  • Ele só lê e grava dentro da pasta atual.
  • O token fica em .promisse/config.json, e a pasta se ignora sozinha no Git.
  • Arquivo apagado no computador é removido no servidor só se tiver vindo de um pull.
  • Se o tema mudou no painel depois do seu último pull, o push é recusado para você não sobrescrever nada. Rode promisse pull antes, ou use --force se quiser substituir.

Tema no ar#

Se o token foi gerado por quem não pode publicar, o push em um tema publicado é recusado. Para editar o tema no ar, a pessoa precisa também da permissão de publicar templates.

Em tema publicado, um arquivo com erro faz o envio inteiro ser recusado. Em tema fora do ar, o envio passa e os problemas aparecem como aviso.

Mensagens do CLI#

Mensagem O que fazer
Nenhum tema conectado nesta pasta Rode promisse login <token>.
Este não parece ser um token de tema Copie o token de novo. Ele começa com pmt_.
Rode promisse pull antes do primeiro push Baixe o tema antes de enviar.
Use um endereço https para a API Só localhost aceita http.
... passou do limite de 256 KB Divida o arquivo.

Um token revogado ou substituído responde com erro de autenticação. Gere outro no painel e rode promisse login de novo.