Sviluppo di blocchi nativo per l’IA
File e nessuna fase di build: ciò che gli agenti sanno fare bene.
Descrivi un blocco, ottieni un blocco
Gli agenti di programmazione AI possono creare lo scheletro di blocchi, pagine e pattern partendo da un solo prompt. Nessuna interfaccia grafica né database: solo file.
~/starter-theme
❯ Crea un blocco prezzi con tre livelli, un selettore mensile/annuale e un invito all’azione per ciascun livello.
✓ Data di creazione pricing/block.json
✓ Data di creazione pricing/index.php
✓ Data di creazione pricing/style.css
❯ Ora crea una pagina dei prezzi con un hero e una sezione FAQ.
✓ Data di creazione pages/pricing/page.json
✓ Data di creazione pages/pricing/index.php
File
blockstudio/
├── pricing/ Nuovo
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Nuovo
├── page.json
└── index.php
Tutto basato su file
Blocchi, pagine, pattern ed estensioni sono directory con configurazione e template JSON. Gli agenti li leggono e modificano in modo nativo.
Configurazione senza database
Nessun pannello di amministrazione da navigare. Ogni impostazione è una chiave JSON, così un agente può creare la libreria senza browser.
Struttura prevedibile
Ogni blocco segue la stessa convenzione: block.json, un template e stili facoltativi. Impara il modello una volta sola.
Contesto, senza supposizioni
Un indice compatto della documentazione, con il testo completo per gli strumenti che lo vogliono tutto.
Un indice che l’agente legge per primo
blockstudio-llm.txt elenca una volta ogni documento, con route, file sorgente, scopo, impostazioni, hook, funzioni PHP e comandi CLI associati. Con circa 11k token, un agente lo legge tutto e poi apre solo la pagina necessaria.
blockstudio-llm-full.txt include in un file tutti i documenti e tutti gli schemi JSON, circa 169k token, per gli strumenti che vogliono l’intero corpus. Attiva ai.enableContextGeneration e il tuo sito li serve entrambi.
# 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 contratto per il tuo progetto
La documentazione descrive Blockstudio. AGENTS.md descrive il progetto che l’agente sta per modificare.
Un comando genera AGENTS.md
vendor/bin/blockstudio-agents descrive il progetto in cui viene eseguito: cosa contiene, quali funzionalità abilita blockstudio.json, cosa verrà rifiutato dall’analisi e quali comandi sono applicabili.
Ogni riga proviene dai tuoi file, dalle tue impostazioni o dal preset di analisi selezionato. La rigenerazione conserva le note scritte a mano e --check fallisce se il contratto non è aggiornato.
# 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 --checkErrori rilevati prima del commit
Quattro preset di analisi, ciascuno estensione del precedente, e un hook che li esegue a ogni commit.
Analisi consapevole di block.json
I preset blockstudio/phpstan analizzano blocchi, pagine e impostazioni. L’analisi fallisce se un template legge un campo non dichiarato dal suo block.json o lo stampa senza escape.
I template leggono un $a tipizzato dal block.json accanto a essi, con un tipo PHP concreto per ogni tipo di campo, mentre Db::get() restituisce record strutturati secondo db.php. Un percorso di impostazioni o un nome di hook scritto in modo errato genera un errore con il suggerimento del nome reale più simile.
Configura githooks.commit ed esegui vendor/bin/blockstudio-githooks sync: l’hook pre-commit gestito esegue la stessa analisi, così un blocco difettoso non arriva al 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
Ogni chiave $a letta da un template esiste in block.json; hook, percorsi delle impostazioni e tag dei blocchi sono reali.
theme
Intestazioni dei temi, risorse dichiarate, ambito %selector%, valori predefiniti dei campi e limiti dei ripetitori.
extreme-theme
Limite massimo PHPStan, output con escape, nessuna esecuzione di comandi shell, classi Tailwind valide e JavaScript pulito.
wordpress-render
Tema Extreme e una sonda di rendering WordPress attiva fornita da voi. Funziona senza shell e un rendering non riuscito genera una segnalazione.
Twig, Blade e script
Twig, Blade e i tag dei blocchi vengono verificati rispetto agli stessi campi. Il livello Extreme legge anche JavaScript e le direttive Interactivity e le confronta con il markup e gli store.
Progetti esistenti
Una baseline PHPStan tiene da parte le segnalazioni registrate, mentre il nuovo codice deve rispettare il preset completo. blockstudioScanRoots legge le librerie di blocchi esterne alla radice e gli stub inclusi definiscono i tipi dell’API pubblica API.
Inventario e rendering da PHP
Bastano poche chiamate perché un agente possa vedere cosa registra un progetto, eseguirne il rendering in ogni sua parte e controllare cosa ha salvato.
Interroga il progetto, visualizza la risposta
Canvas::inventory() restituisce ogni pagina, blocco, pattern, template dell’Editor del sito, parte di template ed esempio UI registrato nel progetto, senza eseguire il rendering.
Render::document() esegue il rendering di ciascuno come documento HTML completo, con esattamente le risorse utilizzate, così un agente può verificare il lavoro fuori dall’editor.
Canvas::documents() renderizza esattamente i record selezionati. Render::composition() e Render::content() restituiscono dichiarazioni annidate o contenuti di blocchi serializzati come HTML, mentre Ui::inventory() e Ui::examples() elencano le famiglie di componenti incluse, ciascuna con una dichiarazione renderizzabile.
Per un singolo blocco, bs_block_fields(), bs_block_extension_fields(), bs_block_values() e bs_block_assets() restituiscono i suoi campi, valori e asset senza renderizzarlo, mentre bs_validate_block() controlla gli attributi salvati prima che li salviate.
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=jsonMeno della metà dei token per pagina
Gli agenti scrivono semplice HTML. Blockstudio lo converte in markup a blocchi WordPress serializzato durante la sincronizzazione: meno da generare e meno errori.
Blockstudio
Cosa scrivono gli agenti
<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
Cosa scrive il parser per questo
<!-- 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 -->Misurato sui due pannelli qui sopra: 540 caratteri di HTML rispetto ai 1,233 caratteri del markup del blocco che il parser standard scrive per questo, divisi per quattro, la stima usuale dei caratteri per token. Il markup è mostrato con interruzioni di riga aggiunte per facilitarne la lettura.
Meno output da generare
Gli agenti scrivono HTML senza delimitatori dei blocchi, classi generate o markup contenitore.
Meno possibilità di errore
Il parser garantisce un output valido per i blocchi a partire da un input più semplice.
Più rapido ed economico
Meno token di output significa risposte più rapide e costi inferiori per i modelli.
Funziona con ogni strumento di programmazione IA
Qualsiasi agente in grado di leggere e scrivere file funziona con Blockstudio fin da subito.
Progettato per il flusso di lavoro con l’IA
Blocchi, pagine, pattern, impostazioni. Tutto è un file che un agente può leggere, scrivere e modificare.
Due file per blocco
Una configurazione JSON e un template costituiscono l’intero blocco. La superficie ridotta rende affidabile la generazione al primo tentativo.
27 tipi di campo
Testo, file, ripetitori, colori, date e altro, definiti in JSON. Le opzioni si popolano da articoli, termini e utenti.
Validazione dello schema JSON
Ogni configurazione ha uno schema, che fornisce agli agenti regole precise e rileva subito gli errori.
Registrazione automatica
Aggiungi i file a una directory e i blocchi vengono registrati automaticamente, senza un altro elenco di configurazione.
Panoramica su canvas
Ogni pagina gestita oppure ogni blocco con i suoi valori predefiniti, in un’unica vista zoomabile.
Canvas live
La modalità live aggiorna le tavole da disegno interessate tramite Server-Sent Events circa un secondo dopo il salvataggio. Fate clic su un’etichetta per mettere a fuoco una tavola.
Tailwind integrato
TailwindPHP compila le classi usate da ogni pagina, senza configurare Node.
Element Grabber
Copia il percorso del template e il markup di un elemento per fornire subito contesto a un agente.
HTML nei blocchi
Pagine e pattern sono semplici file che diventano blocchi nativi WordPress.
Test rapido di rendering
wp bs blocks render renderizza ogni blocco come farebbe una pagina e termina con 1 se un template genera una notifica, un avviso o un errore.
Controlli sui contenuti salvati
wp bs blocks validate controlla i campi salvati dei post e delle pagine; sync segnala gli attributi che un blocco salva ma non renderizza mai.
Esaminate dal terminale
Elencate impostazioni, campi personalizzati e asset con wp bs, e compilate uno snippet o un file con wp bs tailwind compile o wp bs scss compile.
Il kit ufficiale di estensioni
Template di siti premium, istruzioni di sistema per l’AI e una community privata Discord. Acquisto una tantum, aggiornamenti a vita.
- Oltre 500 modelli di siti
- Istruzioni di sistema per l’AI
- Aggiornamenti a vita
- Community privata di Discord