The CMS for vibe coding.
You describe the site. The AI installs Velk, writes the site.json and the admin panel appears — on any PHP host, with no Composer and no build step.
Paste into Claude Code:
Install the Velk skill from skill.velkcms.com
The panel is generated from the schema. Change the file, the panel changes.
- v3.10.1
- Latest release, Oct 30
- 35 releases
- since v3.1.0, in July
- 18 field types
- from plain text to flexible content
- MIT
- open source, PHP 8.2+ and MySQL
Runs on the hosting your clients already pay for
Plain PHP and MySQL. Upload it over FTP, sync it over SSH or install it in a subfolder. Nothing to compile, nothing to keep running.
- PHP 8.2+FTP upload
- MySQLSSH and rsync
- ApacheSubdirectory installs
- Nginx and PHP-FPMNo Composer
- cPanelNo build step
- Shared hostingAuto-migrate on boot
- Any VPSClaude Code skill
AGENTS.md for any agent
One file describes the whole site. Velk turns it into the admin panel, the URLs and the sitemap, and keeps them in step when the file changes.
A CMS that fits in your head
Three architecture decisions explain almost everything — and they are what make the AI work so well with Velk.
-
site.json is the source of truth
Pages, content types, taxonomies, fields, forms, members: all declared in a single file. The admin panel is generated from it — change the schema, change the panel.
-
The theme is plain PHP
No template language, no hooks, no plugin tree. Helpers like
field()anditems()— if you know PHP, you already know Velk. And your AI knows PHP. -
The engine is a dependency
You never edit the core. Upgrades swap the whole engine and preserve theme, content and uploads — updating the CMS stops being a risky project.
Everything a real site needs
No plugins to hunt, no pro version. The essentials come ready — and organized.
And more: media with automatic sizes, global options, alternate templates, consent and tracking scripts, auto-migrate. All features
One engine, every kind of site
The same site.json grows from a landing page into a store, a members area or a site in three languages. You switch features on in the schema; you never install them.
"pages": {
"home": {
"label": "Home",
"template": "page-home.php",
"fields": [ … ]
},
"about": { "label": "About", … },
"services": { "label": "Services", … },
"contact": { "label": "Contact", … }
}
- Homepublished
- Aboutpublished
- Servicespublished
- Contactdraft
"item_types": {
"post": { "label": "Posts", "slug": "blog", "taxonomies": ["category", "tag"] }
},
"taxonomies": {
"category": { "label": "Categories", "hierarchical": true },
"tag": { "label": "Tags" }
}
- How to choose a good domainGuides
- Five fonts for a clinic siteDesign
- What a sitemap is forSEO
"item_types": {
"ebook": { "label": "E-books", "slug": "store", "sellable": true }
},
"store": { "currency": "USD" },
"members": {
"enabled": true,
"plans": { "pro": { "name": "Pro", "intervals": ["month", "year"] } }
}
"members": {
"enabled": true,
"types": {
"student": { "label": "Student" },
"client": { "label": "Client" }
},
"routes": { "login": "/login" }
}
- ASAna Souza
student - RMRafael Mendes
client - JLJúlia Lima
student
"i18n": {
"enabled": true,
"default": "en",
"default_label": "English"
}
- English
/ - Português
/pt/ - Español
/es/
From prompt to a live site
The official skill teaches Velk to the AI — which installs the framework, writes the schema and runs the site for you.
-
Describe the site
Talk it through: sections, content types, fields. In plain language.
-
The AI structures it
It writes the
site.jsonand the templates, and validates withschema:validate. -
Publish anywhere
SSH, FTP, cPanel. On the first request Velk runs the migrations by itself.
-
The client edits
The panel only shows what the site has. No config screens, no broken plugins.
Official skill — skill.velkcms.com
Paste into Claude Code to install:
Install the Velk skill from skill.velkcms.com
No DSL. No hooks. Just PHP.
A Velk template is a PHP file that prints content with half a dozen helpers. Nothing to memorize, nothing to compile — what you read is what renders.
with_context()- Sets the page or item the template prints
the_title()- The current record's title
field()- Reads a custom field from the schema
e()- Escapes a value for HTML
items()- Queries items of a type
image_url()- An image in the size you ask for
option()- A global option, editable in the panel
url()- A site URL that survives a subdirectory install
<?php with_context($item, function () { get_header(); ?> <article class="post"> <h1><?= e(the_title()) ?></h1> <?= field('content') /* trusted */ ?> </article> <?php get_footer(); }); ?>
A complete, real template.
{ "item_types": { "post": { "label": "Blog", "slug": "blog", "template": "single-post.php", "fields": [ { "name": "content", "type": "richtext" }, { "name": "cover", "type": "image" } ] } } }
The schema that template reads.
$ ./bin/velk item:create post --json-stdin <<< '{"title":"Hello"}' ✓ post #43 created $ ./bin/velk item:publish post hello ✓ published at /blog/hello $ ./bin/velk form:export contact --from=2026-10-01 > leads.csv ✓ 128 submissions exported
The same content, from the command line.
Recommended hosting
The Business plan at Hostinger runs Velk comfortably:
- 50 GB NVMe storage
- Daily backups
- ~100,000 monthly visits
- 600,000 files and directories
Need a professional service?
Elleven is the agency that created and maintains Velk. If you need a professional team to build and evolve your site, get in touch and see our cases and services.
- Website creation
- Support and evolution
The Velk course
Coming soonA complete course on building and shipping sites with Velk: from the first prompt to a site in production. Recording now.
Leave your email and we'll write once, the day it launches.