Como usar
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
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.
No seu computador pra desenvolver (Herd, MAMP, XAMPP) e qualquer hospedagem PHP na hora de publicar. MariaDB 10.2+ também serve.
O manual do Velk que a IA consulta: schema, campos, helpers, CLI e deploy. É o primeiro passo do guia, logo abaixo.
Preparação
Dois passos e o Velk está rodando na sua máquina — sem terminal, sem Composer, sem tutorial de 40 minutos.
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.
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.
Quer instalar na mão, sem IA? O passo a passo manual — download, .env e instalador — está na documentação.
Construção
Estrutura, layout e conteúdo: tudo por prompt. A IA edita o site.json, valida e o painel acompanha na hora.
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:
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.
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
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.
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.
Dicas
Vibe coding rende mais quando o pedido é específico. Conheça quatro padrões que funcionam bem com o Velk.
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.
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.
Schema validado e painel aberto: você confere o resultado na hora.
Valida o schema e abre o painel pra eu conferir os campos novos.
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
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.
Curso · em breve
Um 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.
O Velk é uma criação da Elleven.Digital, unidade de tecnologia do Grupo DLS.
