Claude Code
Ou outro agente de IA que aceite skills. É ele quem vai instalar, estruturar e operar o Velk por você — o seu papel é descrever e aprovar.
Como usar
Crie um site conversando
O caminho completo, por conversa: da instalação ao site publicado, sem sair do Claude Code. Programar sem IA? tem o caminho manual na documentação.
Antes de começar
O que você precisa
PHP 8.2+ e MySQL
No seu computador pra desenvolver (Herd, MAMP, XAMPP…) e qualquer hospedagem PHP na hora de publicar. MariaDB 10.2+ também serve.
A skill oficial
O manual do Velk que a IA consulta: schema, campos, helpers, CLI e deploy. É o primeiro passo do guia, logo abaixo.
Preparação
Comece pela skill
Dois passos e o Velk está rodando na sua máquina — sem terminal, sem Composer, sem tutorial de 40 minutos.
Instale a skill oficial
Tudo começa aqui — até a instalação do Velk é a IA que faz. A skill ensina o framework inteiro pro Claude Code: o formato do site.json, os 17 tipos de campo, os helpers do tema, a CLI e os fluxos de instalação, deploy e upgrade. Com ela, a IA não inventa — ela consulta.
Peça a instalação
Abra o Claude Code na pasta do projeto e peça. A IA baixa a última versão oficial do Velk, verifica o checksum, configura o .env, cria o banco, roda as migrations, cria o seu usuário admin e sobe o servidor de desenvolvimento.
Instala o Velk nessa pasta e cria meu usuário admin.
$ claude
> Instala o Velk nessa pasta e cria meu usuário admin
✦ Baixando a última release e verificando o checksum
✦ .env configurado · banco criado · migrations ok
Pronto: http://localhost:8080 — painel em /admin
Quer instalar na mão, sem IA? O passo a passo manual — download, .env e instalador — está na documentação.
Construção
O site nasce na conversa
Estrutura, layout e conteúdo — tudo por prompt. A IA edita o site.json, valida e o painel acompanha na hora.
Descreva o site
Converse em português mesmo: seções, tipos de conteúdo, campos. A IA escreve o site.json, cria os templates do tema, valida com schema:validate e sobe o dev server pra você ver. Uns exemplos pra roubar:
Cria um site pra uma clínica odontológica: home, página de equipe, blog com categorias e formulário de contato.
Converte esse HTML estático em tema Velk e liga os textos, imagens e o blog no painel.
Refine conversando
Mudou de ideia? É só falar. Campo novo, seção nova, outro layout pra um item específico — a IA edita o schema, valida e o painel acompanha na hora. Nada de migration de conteúdo, nada de plugin.
Adiciona um campo de preço nos serviços e mostra na página, formatado em reais.
Preencha o conteúdo
Entre no /admin e edite como qualquer CMS — ou deixe a IA popular o site pela CLI (item:create, page:update), útil pra migrar conteúdo de um site velho ou gerar rascunhos em lote. O painel mostra só o que o site tem.
Publicação
Do localhost pro ar
Publicar
Qualquer hospedagem com PHP 8.2+ e MySQL serve. Sem SSH? Suba os arquivos por FTP e pronto: no primeiro acesso o Velk aplica as migrations sozinho. Com SSH, peça o deploy pra IA — a skill cobre o fluxo completo, do rsync ao banco.
Faz o deploy desse site pra minha hospedagem via SSH.
Mantenha
Depois do site no ar, upgrades são um pedido: o engine é trocado inteiro, e tema, conteúdo e uploads ficam intocados. O cliente segue editando no painel — e novas seções continuam nascendo por conversa, sempre que você quiser.
Atualiza o Velk desse projeto pra última versão.
Dicas
Prompts que funcionam
Vibe coding rende mais quando o pedido é específico. Quatro padrões que funcionam bem com o Velk:
Descreva o conteúdo, não só o visual
Diga os campos que cada coisa tem — a IA transforma direto em schema.
Cria o tipo "imóvel" com galeria, preço, quartos, bairro e um campo de destaque.
Uma seção por vez
Mudanças pequenas são fáceis de revisar — e de desfazer.
Agora só a seção de depoimentos da home: repeater com foto, nome e texto.
Peça pra validar e mostrar
Schema validado e painel aberto: você confere o resultado na hora.
Valida o schema e abre o painel pra eu conferir os campos novos.
Aproveite o que já existe
Site estático antigo? Vira tema Velk com painel — sem redesenhar nada.
Converte esse HTML em tema Velk mantendo o visual, com textos e imagens editáveis.
Elleven
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