Crie um site conversando
Cada recurso do Velk numa página: o que ele faz, o que pedir para a IA e onde ele aparece no painel. Sem código — só o que digitar.
Vai escrever o código você mesmo? A Documentação cobre o site.json, os templates e os helpers.
Antes do primeiro site
Três passos colocam o Velk no seu computador. As páginas abaixo explicam cada um, como o projeto se organiza e como conversar com a IA para o resultado sair certo.
-
Instale a skill
Cole no Claude Code o comando ao lado. A skill é o que ensina o Velk para a IA.
-
Peça a instalação
Numa pasta nova, peça para a IA instalar o Velk. Ela baixa a versão, cria o banco e o seu usuário do painel.
-
Descreva o site
Diga quais páginas e conteúdos o site tem, e os campos de cada um. O painel administrativo nasce disso.
Cole no Claude Code para instalar:
Instale a skill do Velk de skill.velkcms.com
Depois peça, na pasta do projeto:
Instala o Velk nessa pasta e cria meu usuário admin.
- Instalar a skill do Velk O Claude Code é a IA que constrói o seu site; a skill do Velk é o que ensina o Velk a ela. Instale uma vez, com uma frase, e ela serve todos os projetos.
- Instalar o Velk Um pedido instala o motor, cria o banco e o seu usuário do painel. O que o Velk precisa, o que a IA pergunta e faz, e como abrir o site no seu computador.
- Estrutura do projeto O que mora em cada pasta de um projeto Velk, a regra que deixa as atualizações seguras (nunca editar o motor) e como guardar um histórico com Git.
- Conversando com a IA Como fazer o briefing para o site nascer certo: contexto do negócio, campos com nome, o que fica de fora, revisar antes de aprovar, os modos de permissão do app e conferir cada mudança.
-
O painel
O painel que o Velk gera a partir do seu
site.json: o que tem em cada área, rascunho e publicação, excluir e ordenar listas, usuários e papéis, idioma e endereço.
Construindo o site
Páginas, tipos de conteúdo, campos, blocos, categorias, menus, imagens e o visual: cada parte de um site, e o pedido que cria cada uma.
- Páginas As partes únicas do site — home, sobre, contato —, cada uma com seus campos, mais subpáginas, páginas que o cliente cria no painel e uma 404 sob medida.
- Tipos de conteúdo Coleções que crescem — artigos, cases, serviços, equipe: campos em comum, um endereço por item, rascunhos, uma página de listagem e uma ordem que você arrasta.
- Campos Os 18 tipos de campo que decidem o que o cliente edita — texto, imagem, listas, links, referências —, mais campos condicionais, linhas com nome, grupos, abas e conjuntos reaproveitáveis.
- Páginas por blocos Landing pages que o cliente monta com blocos que você desenhou — destaque, texto, depoimentos, chamada — empilhados e reordenados no painel, sempre com a cara do site.
- Blocos no texto Desde a v3.9.0 o editor de texto aceita blocos desenhados pelo tema — números em destaque, depoimento, chamada para ação — inseridos entre dois parágrafos e preenchidos num formulário curto. Novo na v3.9
- Categorias e tags Organize o conteúdo com categorias e tags. Cada termo ganha sozinho uma página de listagem, pode ficar sob um termo pai, ter campos próprios e seguir uma ordem que você arrasta.
- Menus e opções Logo, telefone, redes sociais, rodapé e menu são do site inteiro. As páginas de opções guardam isso no painel, onde o cliente muda sozinho, sem te ligar.
- Mídia e imagens Toda imagem e todo arquivo passam por uma biblioteca de mídia só: envie uma vez e use em qualquer campo, com texto alternativo por idioma e os tamanhos de cada lugar do site, gerados pelo Velk.
- Visual e temas A aparência de um site Velk mora no tema: os templates e o CSS que a IA escreve. Como pedir mudanças visuais, transformar um site em HTML estático num tema e por que uma mudança de CSS às vezes não aparece.
Recursos do site
O que já vem no Velk e se liga no schema: formulários, SEO, rastreamento e consentimento, idiomas, área de membros, loja e segurança.
- Formulários e leads Formulários de contato, orçamento e candidatura que guardam cada lead no painel, avisam a equipe por e-mail, filtram spam, registram a campanha e podem mandar o lead para um CRM ou uma planilha.
- SEO e sitemap Meta título, meta descrição e imagem de compartilhamento já vêm em toda página e todo conteúdo, e o Velk gera o sitemap e os endereços canônicos. O que pedir à IA, e o que deixar quieto.
- Rastreamento e consentimento Cole GTM, GA4 e pixels na tela Scripts do painel, segure cada um até o visitante aceitar e meça todo lead com um evento de conversão pronto para o seu gerenciador de tags.
- Site em vários idiomas O site em mais de um idioma: um prefixo de endereço por idioma, uma aba por idioma em cada editor e uma tela para traduzir os textos fixos do tema.
- Área de membros Contas para o site público: login, cadastro e troca de senha, tipos de membro com campos próprios e páginas que só membros, ou um tipo de membro, abrem.
- Loja e assinaturas Venda itens avulsos e cobre membros por mês ou por ano pelo Stripe: campo de preço, checkout, pedidos, entrega automática e o portal do cliente.
- Segurança e velocidade O que o Velk protege sozinho, a política de segurança de conteúdo que você escolhe para o site público, os ajustes de um site no ar e o cache que deixa as páginas rápidas.
Publicar e manter
Colocar o site no ar, publicar alterações sem atropelar ninguém, trabalhar em sites de clientes, editar conteúdo por conversa, atualizar o Velk e se recuperar quando algo quebra.
- Publicar o site Coloque o site no ar num servidor de verdade com um pedido: o que preparar, o que a IA pergunta na primeira vez, o que ela faz e o que conferir depois.
- Publicar alterações Mude um site que já está no ar sem perder o que o cliente publicou: o ciclo seguro, a publicação com versão e como a IA junta o trabalho de outras pessoas.
- Sites de clientes Dê a um cliente ou colega acesso a um site com um arquivo pequeno e sem senha. Ele se conecta pelo próprio Claude e escolhe entre uma cópia completa no Mac e editar direto no ar.
- Conteúdo por conversa Crie, edite e publique conteúdo de um site no ar pedindo à IA. Ela lê os campos do site antes, trabalha com os comandos de conteúdo do Velk por SSH e não mexe no tema.
- Atualizar o Velk Leve um site para uma versão mais nova do Velk pedindo. A IA baixa a versão oficial, confere, troca só o motor e preserva o seu tema, o conteúdo e as configurações.
- Backups Peça um backup completo de um site, com arquivos, banco e uploads, baixado para o seu computador. Quando fazer, como restaurar e como guardar com segurança.
- Resolvendo problemas Os problemas comuns num site Velk, da tela branca à mudança que não aparece: o que causa cada um e como descrever um problema para a IA achar rápido.
Hospedagem recomendada
O Plano Business da Hostinger roda o Velk com folga:
- 50 GB de armazenamento NVMe
- Backup diário
- ~100.000 visitas mensais
- 600.000 arquivos e diretórios
Precisa de um serviço profissional?
A Elleven é a agência que criou e mantém o Velk. Se você precisa de uma equipe profissional para criar e evoluir seu site, entre em contato e conheça nossos cases e serviços.
- Criação de sites
- Suporte e evolução
O curso de Velk
Em breveUm curso completo sobre criar e publicar sites com o Velk: do primeiro prompt ao site em produção. Em gravação.
Deixe seu e-mail e escrevemos uma vez, no dia do lançamento.