Create a site by talking
Every Velk feature, one page each: what it does, what to ask the AI and where it shows up in the panel. No code — only the words to type.
Writing the code yourself? The Documentation covers site.json, templates and helpers.
Before the first site
Three steps put Velk on your computer. The pages below explain each one, how the project is organized and how to talk to the AI so the result comes out right.
-
Install the skill
Paste the command on the right into Claude Code. The skill is what teaches Velk to the AI.
-
Ask for the install
In a new folder, ask the AI to install Velk. It downloads the release, creates the database and your admin user.
-
Describe the site
Say which pages and content the site has, and the fields each one needs. The admin panel is generated from that.
Paste into Claude Code to install:
Install the Velk skill from skill.velkcms.com
Then ask, in the project folder:
Install Velk in this folder and create my admin user.
- Install the Velk skill Claude Code is the AI that builds your site; the Velk skill is what teaches it Velk. Install it once, with one sentence, and it serves every project.
- Install Velk One request installs the engine, creates the database and your admin user. What Velk needs, what the AI asks and does, and how to open the site on your computer.
- Project structure What lives in each folder of a Velk project, the rule that keeps updates safe (never edit the engine) and how to keep a history with Git.
- Talking to the AI How to brief the AI so the site comes out right: business context, named fields, what's out, reviewing before you approve, the app's permission modes and checking each change.
-
The admin panel
The panel Velk builds from your
site.json: what each area holds, drafts and publishing, deleting and ordering lists, users and roles, its language and its address.
Building the site
Pages, content types, fields, blocks, categories, menus, images and the look: each part of a site, and the request that creates it.
- Pages The one-of-a-kind parts of a site — home, about, contact — each with its own fields, plus subpages, pages the client creates in the panel and a custom 404.
- Content types Collections that grow — posts, cases, services, team members: shared fields, one address per entry, drafts, a listing page and an order you can drag.
- Fields The 18 field types that decide what the client edits — text, images, lists, links, references — plus conditional fields, labelled rows, groups, tabs and reusable sets.
- Block pages Landing pages the client assembles from blocks you design — hero, text, testimonials, call to action — stacked and reordered in the panel, always in the site's look.
- Blocks in the text Since v3.9.0 the text editor takes blocks the theme designs — big numbers, a testimonial, a call to action — inserted between two paragraphs and filled in a short form. New in v3.9
- Categories and tags Group content with categories and tags. Each term gets its own listing page automatically, can sit under a parent, carry fields of its own and follow an order you drag.
- Menus and options The logo, the phone, the social links, the footer and the menu belong to the whole site. Options pages keep them in the admin, where the client changes them without calling you.
- Media and images Every image and file goes through one media library: uploaded once, reused anywhere, with alt text per language and the sizes each spot on the site needs, generated by Velk.
- Design and themes The look of a Velk site lives in its theme, the templates and CSS the AI writes. How to ask for visual changes, turn a static HTML site into a theme, and why a CSS change sometimes doesn't show.
Site features
What comes with Velk and turns on in the schema: forms, SEO, tracking and consent, languages, a members area, a store and security.
- Forms and leads Contact, quote and application forms that save every lead in the admin, e-mail your team, filter spam, record the campaign and can pass each lead on to a CRM or a spreadsheet.
- SEO and the sitemap Meta title, description and share image come built into every page and item, and Velk generates the sitemap and the canonical addresses. What to ask the AI, and what to leave alone.
- Tracking and consent Paste GTM, GA4 and pixels in the admin's Scripts screen, hold them until the visitor accepts, and measure every lead with a conversion event ready for your tag manager.
- Multi-language sites Serve the site in several languages: one address prefix per language, a tab per language in every editor, and a screen to translate the theme's fixed texts.
- Members area Accounts for the public site: login, sign-up and password reset, member types with their own fields, and pages only members, or one type of member, can open.
- Store and subscriptions Sell items one by one and charge members monthly or yearly through Stripe: price field, checkout, orders, automatic delivery and the customer portal.
- Security and speed What Velk protects on its own, the Content Security Policy you choose for the public site, the settings a live site needs, and how pages get cached for speed.
Publish and maintain
Put the site online, publish changes without overwriting anyone, work on client sites, edit content by conversation, update Velk and recover when something breaks.
- Publish the site Put the site online on a real server with one request: what to prepare, what the AI asks the first time, what it does, and what to check once it's live.
- Publish changes Change a site that's already live without losing what the client published: the safe loop, versioned publishing, and how the AI merges other people's work.
- Client sites Give a client or a colleague access to a site with a small file and no passwords. They connect with their own Claude and choose a full local copy or editing live.
- Content by conversation Create, edit and publish content on a live site by asking the AI. It reads the site's fields first, works through Velk's content commands over SSH and leaves the theme alone.
- Update Velk Move a site to a newer Velk version by asking. The AI downloads the official release, checks it, replaces only the engine and keeps your theme, content and settings.
- Backups Ask for a full backup of a site, with files, database and uploads, downloaded to your computer. When to make one, how to restore it and how to keep it safe.
- Troubleshooting The usual problems on a Velk site, from a white screen to a change that doesn't show: what causes each one and how to describe a problem so the AI finds it fast.
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.