Développement de blocs conçu pour l’IA
Des fichiers et aucune étape de compilation : exactement ce que les agents savent bien gérer.
Décrivez un bloc, obtenez un bloc
Les agents de programmation IA peuvent créer la structure de blocs, de pages et de motifs à partir d’une seule consigne. Sans interface graphique ni base de données, uniquement des fichiers.
~/starter-theme
❯ Crée un bloc de tarification avec trois niveaux, un bouton mensuel/annuel et un appel à l’action pour chaque niveau.
✓ Créé le pricing/block.json
✓ Créé le pricing/index.php
✓ Créé le pricing/style.css
❯ Crée maintenant une page de tarifs avec une section d’accueil et une FAQ.
✓ Créé le pages/pricing/page.json
✓ Créé le pages/pricing/index.php
Fichiers
blockstudio/
├── pricing/ Nouveau
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Nouveau
├── page.json
└── index.php
Tout est basé sur des fichiers
Les blocs, pages, motifs et extensions sont des répertoires contenant une configuration et des modèles JSON. Les agents peuvent les lire et les modifier directement.
Aucune configuration de base de données
Aucun panneau d’administration à parcourir. Chaque paramètre est une clé JSON ; un agent peut donc préparer la bibliothèque sans navigateur.
Structure prévisible
Chaque bloc suit la même convention : block.json, un modèle et des styles facultatifs. Apprenez le principe une fois.
Du contexte, pas des suppositions
Un index compact de la documentation, ainsi que le texte intégral pour les outils qui en ont besoin.
Un index que l’agent lit en premier
blockstudio-llm.txt répertorie une fois chaque document, avec son parcours, son fichier source, son objectif, ainsi que les paramètres, hooks, fonctions PHP et commandes CLI associés. Avec environ 11k jetons, un agent peut le lire en entier, puis ouvrir uniquement la page nécessaire.
blockstudio-llm-full.txt regroupe tous les documents et tous les schémas JSON dans un fichier d’environ 169k jetons, pour les outils qui ont besoin de tout le corpus. Activez ai.enableContextGeneration pour que votre site serve les deux.
# 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 contrat pour votre projet
La documentation décrit Blockstudio. AGENTS.md décrit le projet que l’agent s’apprête à modifier.
Une commande génère AGENTS.md
vendor/bin/blockstudio-agents décrit le projet dans lequel il s’exécute : son contenu, les fonctionnalités activées par blockstudio.json, les motifs de rejet de l’analyse et les commandes applicables.
Chaque ligne provient de vos fichiers, paramètres ou du préréglage d’analyse sélectionné. La régénération conserve vos notes manuelles, et --check échoue si le contrat est obsolète.
# 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 --checkErreurs détectées avant validation
Quatre préréglages d’analyse, chacun englobant le précédent, et un hook qui les exécute à chaque commit.
Une analyse qui connaît block.json
Les préréglages blockstudio/phpstan analysent vos blocs, pages et paramètres. Si un modèle utilise un champ non déclaré par son block.json ou l’affiche sans échappement, l’analyse échoue.
Les modèles lisent un $a typé à partir du block.json situé à côté, avec un type PHP concret pour chaque type de champ, et Db::get() renvoie des enregistrements structurés selon db.php. Un chemin de réglage ou un nom de hook mal orthographié provoque une erreur, accompagnée d’une suggestion indiquant le nom réel le plus proche.
Définissez githooks.commit et exécutez vendor/bin/blockstudio-githooks sync : le hook de prévalidation géré lance la même analyse, empêchant tout bloc défectueux d’être validé.
{
"$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
Chaque clé $a utilisée par un modèle existe dans block.json ; les hooks, chemins de paramètres et balises de bloc sont réels.
theme
En-têtes de thème, ressources déclarées, portée de %selector%, valeurs par défaut des champs et limites des répétiteurs.
extreme-theme
PHPStan max, sortie échappée, aucune commande shell, classes Tailwind valides et JavaScript propres.
wordpress-render
Thème Extreme et sonde de rendu WordPress en direct fournie par vos soins. Elle fonctionne sans shell ; tout échec du rendu est signalé.
Twig, Blade et scripts
Twig, Blade et les balises de bloc sont vérifiés à partir des mêmes champs. La couche Extreme analyse aussi JavaScript et les directives Interactivity en fonction de votre balisage et de vos magasins.
Projets existants
Une base PHPStan met de côté les problèmes déjà signalés, tandis que le nouveau code doit respecter l’intégralité du préréglage. blockstudioScanRoots détecte les bibliothèques de blocs situées hors de la racine, et les stubs fournis typent l’API publique.
Inventaire et rendu depuis PHP
Quelques appels suffisent pour qu’un agent voie ce qu’un projet enregistre, en génère n’importe quelle partie et vérifie ce qu’il a stocké.
Interrogez le projet, affichez la réponse
Canvas::inventory() renvoie chaque page, bloc, motif, modèle de l’éditeur de site, partie de modèle et exemple UI enregistré par un projet, sans rien afficher.
Render::document() affiche chacun d’eux sous forme de document HTML complet avec exactement les ressources utilisées ; un agent peut ainsi vérifier son travail hors de l’éditeur.
Canvas::documents() affiche exactement les enregistrements que vous sélectionnez. Render::composition() et Render::content() renvoient les déclarations imbriquées ou le contenu sérialisé des blocs sous forme de HTML, et Ui::inventory() ainsi que Ui::examples() répertorient les familles de composants intégrées avec une déclaration affichable chacune.
Pour un bloc, bs_block_fields(), bs_block_extension_fields(), bs_block_values() et bs_block_assets() renvoient ses champs, ses valeurs et ses assets sans l’afficher, et bs_validate_block() vérifie les attributs enregistrés avant leur sauvegarde.
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=jsonMoitié moins de jetons par page
Les agents écrivent du HTML simple. Blockstudio le transforme en balisage de blocs WordPress sérialisé lors de la synchronisation : moins à générer et moins de risques d’erreur.
Blockstudio
Ce que les agents écrivent
<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
Ce que le parseur écrit pour cela
<!-- 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 -->Mesure effectuée sur les deux panneaux ci-dessus : 540 caractères de HTML, contre 1,233 caractères de balisage de bloc écrits par le parseur standard, divisés par quatre, l’estimation habituelle du nombre de caractères par jeton. Le balisage est présenté avec des retours à la ligne pour en faciliter la lecture.
Moins de contenu à générer
Les agents écrivent HTML sans délimiteurs de blocs, classes générées ni balisage d’encapsulation.
Moins de risques d’erreur
L’analyseur garantit une sortie de bloc valide à partir de cette entrée simplifiée.
Plus rapide et moins coûteux
Moins de jetons générés signifie des réponses plus rapides et des coûts de modèle réduits.
Compatible avec tous les outils de codage IA
Tout agent capable de lire et d’écrire des fichiers fonctionne avec Blockstudio dès le départ.
Conçu pour le flux de travail IA
Blocs, pages, motifs, paramètres : tout est un fichier qu’un agent peut lire, écrire et modifier.
Deux fichiers par bloc
Une configuration JSON et un modèle constituent tout le bloc. Cette surface réduite rend la génération initiale fiable.
27 types de champs
Texte, fichiers, répétiteurs, couleurs, dates et plus, définis dans JSON. Les listes déroulantes sont alimentées par les publications, termes et utilisateurs.
Validation du schéma JSON
Chaque configuration possède un schéma qui fournit des règles précises aux agents et détecte immédiatement les erreurs.
Enregistrement automatique
Déposez des fichiers dans un répertoire : les blocs sont enregistrés automatiquement, sans liste de configuration supplémentaire.
Vue d’ensemble du canevas
Toutes les pages gérées, ou tous les blocs avec leurs valeurs par défaut, dans une vue unique avec zoom.
Canvas en direct
Le mode en direct actualise les plans de travail concernés via Server-Sent Events environ une seconde après l’enregistrement. Cliquez sur un libellé pour sélectionner un plan de travail.
Intégré à Tailwind
TailwindPHP compile les classes utilisées par chaque page, sans configuration Node.
Element Grabber
Copiez le chemin du modèle et le balisage d’un élément pour fournir instantanément du contexte à un agent.
HTML vers les blocs
Les pages et motifs sont des fichiers simples qui deviennent des blocs WordPress natifs.
Test rapide du rendu
wp bs blocks render affiche chaque bloc comme sur une page et renvoie le code de sortie 1 lorsqu’un modèle déclenche une notification, un avertissement ou une erreur.
Vérifications du contenu enregistré
wp bs blocks validate vérifie les champs enregistrés des publications, et pages sync signale les attributs stockés par un bloc mais jamais affichés.
Inspecter depuis le terminal
Répertoriez les réglages, les champs personnalisés et les assets avec wp bs, puis compilez un extrait ou un fichier avec wp bs tailwind compile ou wp bs scss compile.
Le kit d’extension officiel
Modèles de site premium, instructions système pour l’IA et communauté privée Discord. Achat unique, mises à jour à vie.
- 500+ modèles de sites
- Instructions système de l’IA
- Mises à jour à vie
- Communauté privée Discord