Cómo usar

Crea un sitio conversando

El camino completo, por conversación: de la instalación al sitio publicado, sin salir de Claude Code. ¿Programar sin IA? está el camino manual en la documentación.

Antes de empezar

Lo que necesitas

Claude Code

U otro agente de IA que acepte skills. Es quien va a instalar, estructurar y operar Velk por ti — tu papel es describir y aprobar.

PHP 8.2+ y MySQL

En tu computadora para desarrollar (Herd, MAMP, XAMPP…) y cualquier hosting PHP a la hora de publicar. MariaDB 10.2+ también sirve.

La skill oficial

El manual de Velk que la IA consulta: esquema, campos, helpers, CLI y deploy. Es el primer paso de la guía, justo abajo.

Preparación

Empieza por la skill

Dos pasos y Velk está corriendo en tu máquina — sin terminal, sin Composer, sin tutorial de 40 minutos.

Instala la skill oficial

Todo empieza aquí — hasta la instalación de Velk la hace la IA. La skill le enseña a Claude Code el framework entero: el formato del site.json, los 17 tipos de campo, los helpers del tema, la CLI y los flujos de instalación, deploy y upgrade. Con ella, la IA no inventa — consulta.

Pide la instalación

Abre Claude Code en la carpeta del proyecto y pídelo. La IA descarga la última versión oficial de Velk, verifica el checksum, configura el .env, crea la base de datos, corre las migraciones, crea tu usuario admin y levanta el servidor de desarrollo.

Instala Velk en esta carpeta y crea mi usuario admin.
~/my-site

$ claude

> Instala Velk en esta carpeta y crea mi usuario admin

✦ Descargando la última release y verificando el checksum

✦ .env configurado · base de datos creada · migraciones ok

Listo: http://localhost:8080 — panel en /admin

¿Quieres instalar a mano, sin IA? El paso a paso manual — descarga, .env e instalador — está en la documentación.

Construcción

El sitio nace en la conversación

Estructura, layout y contenido — todo por prompt. La IA edita el site.json, valida y el panel se actualiza al instante.

Describe el sitio

Habla en lenguaje llano: secciones, tipos de contenido, campos. La IA escribe el site.json, crea las plantillas del tema, valida con schema:validate y levanta el dev server para que lo veas. Unos ejemplos para robar:

Crea un sitio para una clínica dental: inicio, página de equipo, blog con categorías y formulario de contacto.
Convierte este HTML estático en un tema Velk y conecta los textos, imágenes y el blog al panel.

Refina conversando

¿Cambiaste de idea? Solo dilo. Un campo nuevo, una sección nueva, otro layout para un item específico — la IA edita el esquema, valida y el panel se actualiza al instante. Sin migración de contenido, sin plugins.

Agrega un campo de precio a los servicios y muéstralo en la página, formateado en dólares.

Rellena el contenido

Entra en /admin y edita como cualquier CMS — o deja que la IA rellene el sitio por la CLI (item:create, page:update), útil para migrar contenido de un sitio viejo o generar borradores en lote. El panel solo muestra lo que el sitio tiene.

Publicación

Del localhost a la web

Publicar

Cualquier hosting con PHP 8.2+ y MySQL sirve. ¿Sin SSH? Sube los archivos por FTP y listo: en la primera petición Velk aplica las migraciones solo. Con SSH, pídele el deploy a la IA — la skill cubre el flujo completo, del rsync a la base de datos.

Haz el deploy de este sitio a mi hosting por SSH.

Mantén

Una vez el sitio en línea, las actualizaciones son solo un pedido: el engine se reemplaza entero, y el tema, el contenido y los uploads quedan intactos. El cliente sigue editando en el panel — y nuevas secciones siguen naciendo por conversación, cuando quieras.

Actualiza Velk en este proyecto a la última versión.

Consejos

Prompts que funcionan

El vibe coding rinde más cuando el pedido es específico. Cuatro patrones que funcionan bien con Velk:

Describe el contenido, no solo lo visual

Di qué campos tiene cada cosa — la IA lo convierte directo en esquema.

Crea el tipo "propiedad" con galería, precio, habitaciones, barrio y un toggle de destacado.

Una sección a la vez

Los cambios pequeños son fáciles de revisar — y de deshacer.

Ahora solo la sección de testimonios de la home: un repeater con foto, nombre y texto.

Pídele que valide y muestre

Esquema validado y panel abierto: revisas el resultado al instante.

Valida el esquema y abre el panel para que revise los campos nuevos.

Aprovecha lo que ya existe

¿Sitio estático antiguo? Se convierte en un tema Velk con panel — sin rediseñar nada.

Convierte este HTML en un tema Velk manteniendo el aspecto, con textos e imágenes editables.

Elleven

¿Necesitas un servicio profesional?

Elleven es la agencia que creó y mantiene Velk. Si necesitas un equipo profesional para crear y hacer evolucionar tu sitio, ponte en contacto y conoce nuestros casos y servicios.

  • Creación de sitios
  • Soporte y evolución
Conocer Elleven