Um site Velk tem três partes: a estrutura é um arquivo (site.json), o conteúdo está no banco, e a aparência é o tema — os templates das páginas em theme/templates/, os pedaços reaproveitados como cabeçalho e rodapé em theme/partials/, e o CSS (as regras de estilo), os scripts e as imagens ao lado. Tudo que o visitante vê — cor, fonte, espaçamento, layout — vem do tema, e quem escreve é a IA.
O cliente mexe no conteúdo pelo painel, nunca no visual. Um post novo ou um bloco novo sempre sai com a cara do site, e o painel não tem como mudar o layout.
Como pedir uma mudança visual
- Dê referência. Um site que você gosta, o manual da marca, os códigos de cor e os nomes das fontes, um layout desenhado (uma imagem ou um PDF anexado na conversa). “Moderno e clean” não diz nada para ninguém; “cards como os desta página, no nosso azul
#1A3D8F” diz. - Uma mudança por vez. “Título maior no hero” e depois “mais espaço entre os serviços”: dois pedidos que você confere um a um.
- Diga onde vale — só na home, em todas as páginas, só nos posts — e o que não pode mudar.
- Confira no celular. Estreite a janela do navegador ou abra a página no celular, e descreva o que quebra: “no celular o menu cobre o logo”.
Peça à IA
No hero da home (a seção grande de abertura), aumenta o título — uns 56px no computador, 36px no celular —, mantém a fonte e deixa mais espaço entre o título e o botão. Não mexe em mais nada no site.
Uma mudança que dá para medir, num lugar só, dizendo o que fica igual: fácil de conferir e fácil de desfazer.
Para uma página nova
Cria a página “Workshops” seguindo o layout anexado. Coloca os estilos dela num arquivo CSS próprio, carregado só por essa página, para nada mais no site mudar enquanto a gente ajusta.
Uma página em construção com CSS próprio aguenta várias rodadas sem quebrar o resto do site. Um ajuste pontual numa regra que já existe é feito onde a regra já mora.
De um site em HTML estático para um tema Velk
Um site em HTML puro — um template comprado, um site estático antigo, um layout exportado em HTML — pode virar um tema Velk com o painel já preenchido. Coloque os arquivos na pasta do projeto e peça: converte esse HTML num tema velk. A primeira parada da skill é um plano para você aprovar.
Peça à IA
Converte esse HTML num tema velk. Os arquivos estão na pasta site-antigo. Mantém o visual idêntico. O blog vira tipo de conteúdo, os depoimentos viram uma lista editável, e o menu e os contatos do rodapé vão para as opções. Me mostra o plano antes de gerar qualquer coisa.
Dizer como você quer dividir o conteúdo deixa o plano mais perto do que você precisa já na primeira tentativa.
O que a skill faz
-
Separa o original
Os arquivos originais vão para uma pasta
_source/na raiz do projeto, fora do tema. Se o Velk ainda não estiver instalado, ela propõe instalar e espera o seu sim. -
Lê cada página
Cabeçalho e rodapé repetidos viram pedaços reaproveitados, cards repetidos uma lista ou um tipo de conteúdo, menu e contatos opções, os textos campos da página. Ela também recolhe os textos e as imagens escritos no HTML.
-
Mostra o plano
Páginas e campos, tipos de conteúdo, opções e com o que o painel vai nascer preenchido. Nada é gerado antes da sua aprovação.
-
Monta e preenche
Escreve o
site.json, os templates e o CSS; depois um script de uma vez só copia o conteúdo antigo para o banco, e o painel abre preenchido. -
Diz o que falta
Imagens para passar à biblioteca de mídia (até lá aparecem os arquivos originais), destinatários de formulário para configurar, scripts de rastreamento (pixel, chat) para cadastrar na tela Scripts, e a
_source/para apagar depois que você aprovar — o primeiro deploy não roda com ela ali.
Por que a mudança de CSS não aparece
As regras de servidor do Velk (o arquivo .htaccess) mandam o navegador guardar CSS e JavaScript por um mês. Isso deixa o site mais rápido, e quer dizer que uma folha de estilo carregada sempre do mesmo endereço continua mostrando a versão antiga para quem volta ao site — às vezes até para você. A correção está no tema: cada arquivo de CSS e JS é carregado com uma versão no endereço, tirada da última alteração do arquivo, então cada mudança ganha um endereço novo que todo navegador busca.
Os temas que a skill monta já fazem isso, e a publicação versionada avisa quando o CSS ou o JS mudou sem essa versão. Num tema mais antigo, peça uma vez: “carrega o CSS e o JS com versão no endereço”.
Perguntas
O cliente consegue mudar cor ou fonte pelo painel?
Por padrão, não: o visual está no tema. Se o cliente precisa trocar alguma coisa — a cor de um banner, uma imagem de temporada —, peça uma opção que o tema leia, como uma escolha entre as cores da marca.
Mudei o CSS e o site continua igual.
Se só você vê a versão antiga, recarregue ignorando o cache (Cmd/Ctrl+Shift+R na maioria dos navegadores). Se todo mundo vê, o tema carrega o CSS sem versão no endereço: peça para a IA acrescentar.