CMS minimalista em PHP 8.2+ e MySQL

O CMS para
Vibe Coding

Um CMS flexível de verdade, feito para dar ritmo às ideias que movem o seu negócio. Você descreve, a IA instala o Velk, escreve o site.json e o painel aparece — rodando em qualquer hospedagem PHP.

Cole no Claude Code — a IA baixa e instala o Velk pra você:

Instale a skill elleven-digital/velk-skill em ~/.claude/skills/velk e recarregue as skills.
vibe session

Cria um blog com categorias e um campo de autor.

Adicionando o tipo post ao site.json…

  • +1 tipo
  • +2 campos
  • +1 taxonomia
theme/site.json
{
  "item_types": {
    "post": {
      "label": "Blog",
      "slug": "blog",
      "template": "single-post.php",
      "taxonomies": ["categoria"],
      "fields": [
        { "name": "content", "type": "richtext" },
        { "name": "autor", "type": "text" }
      ]
    }
  }
}
/admin — painel gerado
velk
  • Páginas
  • Blog novo
  • Mídia
  • Formulários
  • Opções
Novo post Publicar
Título Como escolher um bom domínio
Autor Ana Souza
Categoria Guias
Conteúdo
terminal

$

✓ Schema válido — painel atualizado.

  • PHP 8.2+
  • MySQL
  • Zero Composer
  • Zero build
  • FTP ou SSH
  • Sub-diretório ok

Por que Velk

Um CMS que cabe na cabeça

Três decisões de arquitetura explicam quase tudo — e são elas que fazem a IA trabalhar tão bem com o Velk.

site.json é a fonte da verdade

Páginas, tipos de conteúdo, taxonomias, campos, formulários, membros: tudo declarado num único arquivo. O painel administrativo é gerado dele — mudou o schema, mudou o painel.

O tema é PHP puro

Sem linguagem de template, sem hooks, sem árvore de plugins. Helpers como field() e items() — se você sabe PHP, já sabe Velk. E a sua IA sabe PHP.

O engine é uma dependência

Você nunca edita o core. Upgrades trocam o engine inteiro e preservam tema, conteúdo e uploads — atualizar o CMS deixa de ser um projeto de risco.

Vibe coding

Do prompt ao site no ar

A skill oficial ensina o Velk pra IA — que instala o framework, escreve o schema e opera o site por você.

  1. Descreva o site

    Converse: seções, tipos de conteúdo, campos. Em português mesmo.

  2. A IA estrutura

    Ela escreve o site.json e os templates, e valida com schema:validate.

  3. Publique onde quiser

    SSH, FTP, cPanel. No primeiro acesso o Velk roda as migrations sozinho.

  4. O cliente edita

    O painel mostra só o que o site tem. Sem telas de configuração, sem plugin quebrando.

Ver o passo a passo completo
~/my-site

$ claude

> Cria um site pra clínica com blog e página de equipe

✦ Escrevendo theme/site.json

✦ Criando templates em theme/templates/

✦ ./bin/velk schema:validate ok

✦ ./bin/velk page:sync ok

 

$ ./bin/velk serve

Velk rodando em http://localhost:8080

Recursos

Tudo que um site de verdade precisa

Sem plugins pra caçar, sem versão pro. O essencial já vem pronto — e organizado.

17 tipos de campo

Do texto simples ao conteúdo flexível estilo ACF — com galerias, repetidores e relacionamentos entre conteúdos.

  • text
  • textarea
  • richtext
  • image
  • gallery
  • select
  • boolean
  • number
  • email
  • url
  • date
  • repeater
  • flexible
  • link
  • item
  • group
  • tabs

Painel gerado do schema

As telas de edição nascem do site.json: o cliente só vê o que o site realmente tem.

SEO embutido

Meta title, description e og:image em toda página e item, mais sitemap automático.

Formulários prontos

CSRF + honeypot, submissões salvas no banco e enviadas por e-mail.

Multi-idioma

URLs com prefixo por idioma, tradução por conteúdo e fallback configurável.

CLI feita para agentes

Tudo que o painel faz, a bin/velk faz por JSON — criar conteúdo, publicar, validar schema. É o que deixa a IA operar o site de ponta a ponta.

$ ./bin/velk item:create post --json-stdin

Área de membros

Logins do site — clientes, alunos, leads — separados dos usuários do admin, com tipos e campos próprios.

E mais: mídia com tamanhos automáticos, opções globais, templates alternativos, auto-migrate… Todos os recursos

Para devs — e suas IAs

Sem DSL. Sem hooks. Só PHP.

Um template do Velk é um arquivo PHP que imprime conteúdo com meia dúzia de helpers. Nada pra decorar, nada pra compilar — o que você lê é o que renderiza.

  • field()
  • e()
  • items()
  • image_url()
  • option()
  • the_title()
  • url()
  • with_context()
theme/templates/single-post.php
<?php with_context($item, function () {
    get_header(); ?>

    <article class="post">
        <h1><?= e(the_title()) ?></h1>
        <?= field('content') /* trusted */ ?>
    </article>

<?php get_footer(); }); ?>

single-post.php — um template completo, de verdade.

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
Conhecer a Elleven