KI-native Blockentwicklung
Dateien und kein Buildschritt – genau das liegt Agents.
Beschreibe einen Block, erhalte einen Block
KI-Coding-Agenten können mit einem Prompt Blöcke, Seiten und Muster erstellen. Keine GUI und keine Datenbank, nur Dateien.
~/starter-theme
❯ Erstelle einen Preisblock mit drei Tarifen, einem Monats-/Jahres-Schalter und einem CTA für jeden Tarif.
✓ Erstellt pricing/block.json
✓ Erstellt pricing/index.php
✓ Erstellt pricing/style.css
❯ Erstelle jetzt eine Preisseite mit Hero- und FAQ-Abschnitt.
✓ Erstellt pages/pricing/page.json
✓ Erstellt pages/pricing/index.php
Dateien
blockstudio/
├── pricing/ Neu
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Neu
├── page.json
└── index.php
Alles dateibasiert
Blöcke, Seiten, Muster und Erweiterungen sind Verzeichnisse mit JSON-Konfiguration und Vorlagen. Agents lesen und bearbeiten sie direkt.
Keine Datenbankkonfiguration
Keine Admin-Oberflächen zum Durchklicken. Jede Einstellung ist ein JSON-Schlüssel, sodass ein Agent die Bibliothek ohne Browser anlegen kann.
Vorhersehbare Struktur
Jeder Block folgt derselben Konvention: block.json, eine Vorlage und optionale Stile. Das Muster einmal lernen.
Kontext statt Vermutungen
Ein kompakter Dokumentationsindex plus der vollständige Text für Tools, die alles benötigen.
Ein Index, den der Agent zuerst liest
blockstudio-llm.txt listet jedes Dokument einmal mit Route, Quelldatei, Zweck sowie den zugehörigen Einstellungen, Hooks, PHP-Funktionen und CLI-Befehlen auf. Mit etwa 11k Tokens liest ein Agent den Index vollständig und öffnet dann nur die benötigte Seite.
blockstudio-llm-full.txt enthält alle Dokumente und das JSON-Schema in einer Datei mit etwa 169k Tokens – für Tools, die den gesamten Bestand benötigen. ai.enableContextGeneration aktivieren, dann stellt deine Website beides bereit.
# 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.Ein Vertrag für dein Projekt
Die Dokumentation beschreibt Blockstudio. AGENTS.md beschreibt das Projekt, das der Agent gleich ändert.
Ein Befehl schreibt AGENTS.md
vendor/bin/blockstudio-agents beschreibt das Projekt, in dem es ausgeführt wird: seine Inhalte, die von blockstudio.json aktivierten Funktionen, die von der Analyse beanstandeten Punkte und die geltenden Befehle.
Jede Zeile stammt aus deinen Dateien, Einstellungen oder dem gewählten Analyseprofil. Beim Neuerstellen bleiben deine handschriftlichen Notizen erhalten, und --check schlägt fehl, wenn der Vertrag veraltet ist.
# 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 --checkFehler vor dem Commit erkennen
Vier Analyse-Voreinstellungen, von denen jede den Umfang der vorherigen erweitert, sowie ein Hook, der sie bei jedem Commit ausführt.
Analyse mit Kenntnis von block.json
Die blockstudio/phpstan-Profile prüfen deine Blöcke, Seiten und Einstellungen. Liest eine Vorlage ein Feld, das ihr block.json nicht deklariert hat, oder gibt es ungefiltert aus, schlägt die Analyse fehl.
Vorlagen lesen ein $a, das neben ihnen aus dem block.json geladen wird, mit einem konkreten PHP-Typ für jeden Feldtyp, und Db::get() gibt Datensätze zurück, die nach db.php aufgebaut sind. Ein falsch geschriebener Einstellungspfad oder Hook-Name führt zu einem Fehler mit Vorschlag des ähnlichsten gültigen Namens.
githooks.commit einrichten und vendor/bin/blockstudio-githooks sync ausführen: Der verwaltete Pre-Commit-Hook startet dieselbe Analyse, damit kein fehlerhafter Block in einen Commit gelangt.
{
"$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
Jeder $a-Schlüssel, den eine Vorlage liest, ist in block.json vorhanden; Hooks, Einstellungspfade und Block-Tags sind gültig.
theme
Theme-Header, deklarierte Assets, %selector%-Geltungsbereiche, Feldstandards und Grenzen für Wiederholungsfelder.
extreme-theme
PHPStan max, escapte Ausgabe, keine Shell-Aufrufe, gültige Tailwind-Klassen und sauberes JavaScript.
wordpress-render
Extreme-Theme plus eine Live-WordPress-Render-Prüfung, die du bereitstellst. Sie läuft ohne Shell, und ein fehlgeschlagener Render wird als Befund erfasst.
Twig, Blade und Skripte
Twig, Blade und Block-Tags werden anhand derselben Felder geprüft. Die Extreme-Ebene liest außerdem JavaScript und Interactivity-Direktiven aus deinem Markup und deinen Stores.
Bestehende Projekte
Eine PHPStan-Baseline hält erfasste Befunde zurück, während neuer Code das vollständige Preset erfüllt. blockstudioScanRoots liest Blockbibliotheken außerhalb des Stammverzeichnisses ein, und mitgelieferte Stubs typisieren das öffentliche API.
Bestandsaufnahme und Rendering aus PHP
Mit wenigen Aufrufen kann ein Agent sehen, was ein Projekt registriert, beliebige Teile davon rendern und prüfen, was es gespeichert hat.
Das Projekt abfragen, die Antwort rendern
Canvas::inventory() gibt jede registrierte Seite, jeden Block und jedes Muster, jede Site-Editor-Vorlage und jeden Vorlagenteil sowie jedes UI-Beispiel zurück, ohne etwas zu rendern.
Render::document() rendert jedes davon als vollständiges HTML-Dokument mit genau den verwendeten Assets, damit ein Agent seine Arbeit außerhalb des Editors prüfen kann.
Canvas::documents() rendert genau die von dir ausgewählten Datensätze. Render::composition() und Render::content() geben verschachtelte Deklarationen oder serialisierte Blockinhalte als HTML zurück, und Ui::inventory() sowie Ui::examples() listen die gebündelten Komponentenfamilien mit jeweils einer renderbaren Deklaration auf.
Für einen Block geben bs_block_fields(), bs_block_extension_fields(), bs_block_values() und bs_block_assets() seine Felder, Werte und Assets zurück, ohne ihn zu rendern, und bs_validate_block() prüft gespeicherte Attribute, bevor du sie speicherst.
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=jsonWeniger als halb so viele Tokens pro Seite
Agents schreiben einfaches HTML. Blockstudio wandelt es beim Synchronisieren in serialisiertes WordPress-Block-Markup um: weniger zu generieren und weniger Fehlerquellen.
Blockstudio
Was Agenten schreiben
<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
Was der Parser dafür schreibt
<!-- 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 -->Gemessen an den beiden obigen Panels: 540 Zeichen HTML im Vergleich zu 1,233 Zeichen Block-Markup, die der Standard-Parser dafür schreibt, geteilt durch vier, die übliche Schätzung der Zeichen pro Token. Das Markup wird zur besseren Lesbarkeit mit hinzugefügten Zeilenumbrüchen angezeigt.
Weniger Ausgabe generieren
Agents schreiben HTML ohne Blockbegrenzer, generierte Klassen oder Wrapper-Markup.
Weniger Fehlerquellen
Der Parser garantiert gültige Blockausgabe aus der einfacheren Eingabe.
Schneller und günstiger
Weniger Ausgabetokens bedeuten schnellere Antworten und geringere Modellkosten.
Funktioniert mit jedem KI-Coding-Tool
Jeder Agent, der Dateien lesen und schreiben kann, funktioniert sofort mit Blockstudio.
Für den KI-Workflow entwickelt
Blöcke, Seiten, Muster und Einstellungen: Alles ist eine Datei, die ein Agent lesen, schreiben und bearbeiten kann.
Zwei Dateien pro Block
Eine JSON-Konfiguration und eine Vorlage bilden den ganzen Block. Die kleine Oberfläche macht die erste Generierung zuverlässig.
27 Feldtypen
Text, Dateien, Wiederholungsfelder, Farben, Datumsangaben und mehr, definiert in JSON. Auswahlfelder beziehen Einträge aus Beiträgen, Begriffen und Benutzern.
JSON-Schemaüberprüfung
Jede Konfiguration hat ein Schema, das Agents genaue Regeln vorgibt und Fehler sofort erkennt.
Automatische Registrierung
Dateien in ein Verzeichnis legen und Blöcke automatisch registrieren lassen – ganz ohne zusätzliche Konfigurationsliste.
Canvas-Übersicht
Jede verwaltete Seite oder jeder Block mit seinen Standardwerten in einer einzigen zoombaren Ansicht.
Live-Canvas
Der Live-Modus aktualisiert betroffene Artboards etwa eine Sekunde nach dem Speichern über Server-Sent Events. Klicke auf eine Beschriftung, um ein Artboard in den Fokus zu nehmen.
Tailwind integriert
TailwindPHP kompiliert die Klassen, die jede Seite verwendet, ganz ohne Node-Konfiguration.
Element Grabber
Den Vorlagenpfad und das Markup eines Elements kopieren, um einem Agent sofort Kontext zu geben.
HTML zu Blöcken
Seiten und Muster sind einfache Dateien, aus denen native WordPress-Blöcke werden.
Render-Smoke-Test
wp bs blocks render rendert jeden Block wie auf einer Seite und beendet sich mit 1, wenn eine Vorlage einen Hinweis, eine Warnung oder einen Fehler auslöst.
Prüfungen gespeicherter Inhalte
wp bs blocks validate prüft die gespeicherten Felder von Beiträgen, und pages sync warnt vor Attributen, die ein Block speichert, aber nie rendert.
Im Terminal prüfen
Liste Einstellungen, benutzerdefinierte Felder und Assets mit wp bs auf und kompiliere einen Snippet oder eine Datei mit wp bs tailwind compile oder wp bs scss compile.
Das offizielle Erweiterungspaket
Premium-Websitevorlagen, KI-Systemanweisungen und eine private Discord-Community. Einmaliger Kauf, Updates auf Lebenszeit.
- 500+ Website-Vorlagen
- KI-Systemanweisungen
- Updates auf Lebenszeit
- Private Discord-Community