Desarrollo de bloques nativo para IA
Archivos y sin compilación, justo lo que se les da bien a los agentes.
Describe un bloque y obtén un bloque
Los agentes de programación con IA pueden crear la estructura inicial de bloques, páginas y patrones a partir de una sola instrucción. Sin interfaz gráfica ni base de datos, solo archivos.
~/starter-theme
❯ Crea un bloque de precios con tres niveles, un selector mensual/anual y una llamada a la acción para cada nivel.
✓ Creado pricing/block.json
✓ Creado pricing/index.php
✓ Creado pricing/style.css
❯ Ahora crea una página de precios con una sección principal y una sección de preguntas frecuentes.
✓ Creado pages/pricing/page.json
✓ Creado pages/pricing/index.php
Archivos
blockstudio/
├── pricing/ Nuevo
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Nuevo
├── page.json
└── index.php
Todo basado en archivos
Los bloques, las páginas, los patrones y las extensiones son directorios con configuración JSON y plantillas. Los agentes los leen y editan de forma nativa.
Configuración sin base de datos
Sin paneles de administración en los que hacer clic. Cada ajuste es una clave JSON, así que un agente puede crear la estructura de la biblioteca sin navegador.
Estructura predecible
Todos los bloques siguen la misma convención: block.json, una plantilla y estilos opcionales. Aprende el patrón una sola vez.
Contexto, no conjeturas
Un índice compacto de la documentación, más el texto completo para las herramientas que lo necesitan todo.
Un índice que el agente lee primero
blockstudio-llm.txt enumera cada documento una sola vez, con su ruta, archivo de origen, propósito y los ajustes, hooks, funciones PHP y comandos CLI que controla. Con unos 11k tokens, el agente lo lee entero y luego abre solo la página que necesita.
blockstudio-llm-full.txt reúne todos los documentos y el esquema JSON en un archivo de unos 169k tokens, para las herramientas que necesitan todo el corpus. Activa ai.enableContextGeneration y tu sitio ofrecerá ambos.
# Blockstudio documentation index
This is the primary context file for coding assistants. It is an index, not
the documentation itself. Each entry names one document, what it is for, and
the identifiers that document owns. Read this index, then open only the
document you need.
Every document is addressable two ways: as a URL on https://blockstudio.dev,
and as a Markdown file in the Blockstudio repository. The full text of every
document and schema is also available in one file at /blockstudio-llm-full.txt
for tools that want everything at once.Un contrato para tu proyecto
La documentación describe Blockstudio. AGENTS.md describe el proyecto que el agente está a punto de modificar.
Un comando genera AGENTS.md
vendor/bin/blockstudio-agents describe el proyecto en el que se ejecuta: qué contiene, qué funciones habilita blockstudio.json, qué rechazará el análisis y qué comandos se aplican.
Cada línea procede de tus archivos, tus ajustes o el perfil de análisis seleccionado. Al regenerar se conservan las notas escritas a mano, y --check falla si el contrato está desactualizado.
# Blockstudio contract for Acme
## Project
- Kind: WordPress theme `Acme`.
- Configuration: `blockstudio.json`.
- Analysis preset: `extreme-theme`.
## What this project contains
- Blocks: 1 in `blockstudio`.
- Pages: 1 in `pages`.
- Block namespaces: `acme`.
- Block templates are written in PHP.# Write or refresh the contract
vendor/bin/blockstudio-agents
# Fail CI when it no longer matches the project
vendor/bin/blockstudio-agents --checkErrores detectados antes del commit
Cuatro preajustes de análisis, cada uno una extensión del anterior, y un hook que los ejecuta en cada commit.
Análisis que conoce block.json
Los perfiles de blockstudio/phpstan leen tus bloques, páginas y ajustes. El análisis falla si una plantilla lee un campo que su block.json no declaró o lo muestra sin escapar.
Las plantillas leen un $a tipado desde el block.json que tienen al lado, con un tipo PHP concreto para cada tipo de campo, y Db::get() devuelve registros con la estructura de db.php. Si una ruta de ajustes o un nombre de hook está mal escrito, se sugiere el nombre real más parecido.
Configura githooks.commit y ejecuta vendor/bin/blockstudio-githooks sync: el hook de precommit gestionado ejecuta el mismo análisis, así ningún bloque defectuoso llega a un commit.
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"phpstan": { "preset": "extreme-theme" },
"githooks": { "commit": true }
}$ vendor/bin/blockstudio-githooks sync
$ vendor/bin/blockstudio-phpstan -- --no-progress
Line blockstudio/hero/index.php
3 Dynamic Blockstudio attributes must be escaped before output.
blockstudio.output.unescaped
3 Field "subtitle" does not exist in block.json (block: acme/hero).
blockstudio.fieldbase
Todas las claves $a que lee una plantilla existen en block.json; los hooks, las rutas de configuración y las etiquetas de bloque son reales.
theme
Encabezados de tema, recursos declarados, alcance de %selector%, valores predeterminados de campos y límites de repetidores.
extreme-theme
Máximo de PHPStan, salida escapada, sin ejecutar comandos de shell, clases Tailwind válidas y JavaScript limpios.
wordpress-render
Tema Extreme y una sonda de renderizado en vivo de WordPress que usted proporciona. Se ejecuta sin shell y, si falla el renderizado, se genera un hallazgo.
Twig, Blade y scripts
Twig, Blade y las etiquetas de bloque se comprueban con los mismos campos. La capa Extreme también analiza JavaScript y las directivas de Interactivity en relación con su marcado y sus datos.
Proyectos existentes
Una línea base de PHPStan mantiene los hallazgos registrados mientras el código nuevo cumple el ajuste preestablecido completo. blockstudioScanRoots lee bibliotecas de bloques fuera de la raíz, y los stubs incluidos tipan el API público.
Inventario y renderizado desde PHP
Con unas pocas llamadas, un agente puede ver qué registra un proyecto, renderizar cualquier parte y comprobar qué ha guardado.
Consulta el proyecto y muestra la respuesta
Canvas::inventory() devuelve todas las páginas, bloques, patrones, plantillas del Editor del sitio, partes de plantilla y ejemplos UI que registra un proyecto, sin renderizar nada.
Render::document() renderiza cualquiera de ellos como un documento HTML completo con exactamente los recursos que usó, para que un agente pueda comprobar su trabajo fuera del editor.
Canvas::documents() renderiza exactamente los registros que seleccione. Render::composition() y Render::content() devuelven declaraciones anidadas o contenido de bloque serializado como HTML, y Ui::inventory() y Ui::examples() enumeran las familias de componentes incluidas, con una declaración renderizable cada una.
Para un bloque, bs_block_fields(), bs_block_extension_fields(), bs_block_values() y bs_block_assets() devuelven sus campos, valores y recursos sin renderizarlo, y bs_validate_block() comprueba los atributos guardados antes de que los guarde.
use Blockstudio\Canvas;
use Blockstudio\Render;
$project = Canvas::inventory(['blocks' => true]);
foreach ($project['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
$doc = Render::document(
['name' => 'acme/hero', 'data' => ['heading' => 'Hello']],
['title' => 'Hero preview']
);
file_put_contents('hero.html', $doc['html']);$fields = bs_block_fields('acme/card');
$extended = bs_block_extension_fields('core/paragraph');
$assets = bs_block_assets('acme/card');
$block = parse_blocks($post->post_content)[0];
$a = bs_block_values($block['blockName'], $block['attrs']);
$findings = bs_validate_block($block['blockName'], $block['attrs']);$ wp bs blocks render
$ wp bs blocks render acme/card --attributes='{"variant":"wide"}'
$ wp bs blocks validate 42 57 --format=jsonMenos de la mitad de tokens por página
Los agentes escriben HTML simple. Blockstudio lo convierte en marcado de bloques WordPress serializado al sincronizar: menos que generar y menos margen de error.
Blockstudio
Lo que escriben los agentes
<h1>Build Websites That Convert</h1>
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<block name="core/columns">
<block name="core/column">
<h3>Lightning Fast</h3>
<p>Pages load in under one second.</p>
</block>
<block name="core/column">
<h3>Easy to Use</h3>
<p>No technical skills required.</p>
</block>
<block name="core/column">
<h3>SEO Optimized</h3>
<p>Built-in best practices from day one.</p>
</block>
</block>
<img src="/dashboard.jpg" alt="Dashboard" />WordPress
Lo que escribe el analizador para ello
<!-- wp:heading {"level":1} -->
<h1 class="wp-block-heading">Build Websites That Convert</h1>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<!-- /wp:paragraph -->
<!-- wp:columns -->
<div class="wp-block-columns">
<!-- wp:column -->
<div class="wp-block-column">
<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading">Lightning Fast</h3>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>Pages load in under one second.</p>
<!-- /wp:paragraph -->
</div>
<!-- /wp:column -->
<!-- wp:column -->
<div class="wp-block-column">
<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading">Easy to Use</h3>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>No technical skills required.</p>
<!-- /wp:paragraph -->
</div>
<!-- /wp:column -->
<!-- wp:column -->
<div class="wp-block-column">
<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading">SEO Optimized</h3>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>Built-in best practices from day one.</p>
<!-- /wp:paragraph -->
</div>
<!-- /wp:column -->
</div>
<!-- /wp:columns -->
<!-- wp:image {"alt":"Dashboard","url":"/dashboard.jpg"} -->
<figure class="wp-block-image"><img src="/dashboard.jpg" alt="Dashboard"/></figure>
<!-- /wp:image -->Medido en los dos paneles anteriores: 540 caracteres de HTML frente a los 1,233 caracteres del marcado de bloque que escribe el analizador estándar, divididos entre cuatro, la estimación habitual de caracteres por token. El marcado se muestra con saltos de línea para facilitar la lectura.
Menos salida que generar
Los agentes escriben HTML sin delimitadores de bloque, clases generadas ni marcado envolvente.
Menos margen de error
El analizador garantiza una salida de bloques válida a partir de una entrada más sencilla.
Más rápido y económico
Menos tokens de salida significa respuestas más rápidas y menores costes de modelo.
Compatible con todas las herramientas de programación con IA
Cualquier agente que pueda leer y escribir archivos funciona con Blockstudio desde el primer momento.
Diseñado para el flujo de trabajo con IA
Bloques, páginas, patrones y ajustes. Todo es un archivo que un agente puede leer, escribir y modificar.
Dos archivos por bloque
Una configuración JSON y una plantilla conforman todo el bloque. Su pequeña superficie hace fiable la generación desde el primer intento.
27 tipos de campo
Texto, archivos, repetidores, colores, fechas y más, definidos en JSON. Las opciones se completan con entradas, términos y usuarios.
Validación de esquema JSON
Cada configuración tiene un esquema que da reglas exactas a los agentes y detecta errores de inmediato.
Registro automático
Coloca archivos en un directorio y los bloques se registran automáticamente, sin otra lista de configuración.
Vista general del lienzo
Todas las páginas gestionadas, o todos los bloques con sus valores predeterminados, en una sola vista con zoom.
Lienzo en vivo
El modo en vivo actualiza las mesas de trabajo afectadas mediante Server-Sent Events aproximadamente un segundo después de guardar. Haga clic en una etiqueta para enfocar una mesa de trabajo.
Integrado en Tailwind
TailwindPHP compila las clases que usa cada página, sin configurar Node.
Element Grabber
Copia la ruta de plantilla y el marcado de un elemento para dar contexto inmediato a un agente.
HTML a bloques
Las páginas y los patrones son archivos simples que se convierten en bloques WordPress nativos.
Prueba rápida de renderizado
wp bs blocks render renderiza cada bloque como lo haría una página y finaliza con 1 si una plantilla genera un aviso, una advertencia o un error.
Comprobaciones del contenido guardado
wp bs blocks validate comprueba los campos guardados de las entradas, y pages sync advierte sobre los atributos que un bloque guarda pero nunca renderiza.
Inspeccione desde el terminal
Enumere ajustes, campos personalizados y recursos con wp bs, y compile un fragmento o archivo con wp bs tailwind compile o wp bs scss compile.
El kit oficial de extensiones
Plantillas de sitio prémium, instrucciones de sistema para IA y una comunidad privada de Discord. Compra única, actualizaciones de por vida.
- Más de 500 plantillas de sitios web
- Instrucciones del sistema de IA
- Actualizaciones de por vida
- Comunidad privada de Discord