AI-native blokontwikkeling
Bestanden en geen buildstap: precies waar agents goed in zijn.
Beschrijf een blok, krijg een blok
AI-codeeragenten kunnen met één prompt blokken, pagina’s en patronen opzetten. Geen GUI en geen database, alleen bestanden.
~/starter-theme
❯ Maak een prijsblok met drie niveaus, een maand-/jaarschakelaar en een CTA voor elk niveau.
✓ Aangemaakt pricing/block.json
✓ Aangemaakt pricing/index.php
✓ Aangemaakt pricing/style.css
❯ Maak nu een prijspagina met een hero- en FAQ-sectie.
✓ Aangemaakt pages/pricing/page.json
✓ Aangemaakt pages/pricing/index.php
Bestanden
blockstudio/
├── pricing/ Nieuw
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Nieuw
├── page.json
└── index.php
Alles op basis van bestanden
Blokken, pagina’s, patronen en extensies zijn mappen met JSON-configuratie en templates. Agents kunnen ze direct lezen en bewerken.
Geen databaseconfiguratie
Geen beheerschermen om door te klikken. Elke instelling is een JSON-sleutel, zodat een agent de bibliotheek zonder browser kan opzetten.
Voorspelbare structuur
Elk blok volgt dezelfde conventie: block.json, een template en optionele stijlen. Leer het patroon één keer.
Context, geen giswerk
Een compacte documentatie-index, plus de volledige tekst voor tools die alles nodig hebben.
Een index die de agent eerst leest
blockstudio-llm.txt bevat één keer elke documentvermelding, met de route, het bronbestand, het doel en de instellingen, hooks, PHP-functies en CLI-opdrachten die erbij horen. Met ongeveer 11k tokens kan een agent alles lezen en daarna alleen de benodigde pagina openen.
blockstudio-llm-full.txt bevat elk document en JSON-schema in één bestand van ongeveer 169k tokens, voor tools die het volledige corpus nodig hebben. Schakel ai.enableContextGeneration in en uw site biedt beide aan.
# 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.Een contract voor uw project
De documentatie beschrijft Blockstudio. AGENTS.md beschrijft het project dat de agent gaat aanpassen.
Eén opdracht schrijft AGENTS.md
vendor/bin/blockstudio-agents beschrijft het project waarin het wordt uitgevoerd: wat het bevat, welke functies blockstudio.json mogelijk maakt, wat de analyse afkeurt en welke opdrachten van toepassing zijn.
Elke regel komt uit uw bestanden, instellingen of de geselecteerde analysepreset. Bij opnieuw genereren blijven handgeschreven notities behouden, en --check faalt als de contractdefinitie verouderd is.
# 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 --checkFouten opgespoord vóór de commit
Vier analysevoorinstellingen, elk een uitbreiding van de vorige, en een hook die ze bij elke commit uitvoert.
Analyse met kennis van block.json
De blockstudio/phpstan-presets lezen uw blokken, pagina’s en instellingen. Als een template een veld leest dat de bijbehorende block.json niet heeft gedeclareerd, of het onge-escape’t weergeeft, faalt de analyse.
Sjablonen lezen een $a die is getypeerd vanuit de block.json ernaast, met een concreet PHP-type voor elk veldtype, en Db::get() geeft records terug die zijn gevormd door db.php. Een verkeerd gespeld instellingenpad of hooknaam leidt tot een foutmelding met een suggestie voor de dichtstbijzijnde bestaande naam.
Stel githooks.commit in en voer vendor/bin/blockstudio-githooks sync uit: de beheerde pre-commit-hook voert dezelfde analyse uit, zodat een defect blok nooit in een commit terechtkomt.
{
"$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
Elke $a-sleutel die een template leest, bestaat in block.json; hooks, instellingpaden en bloktags zijn echt.
theme
Themakoppen, gedeclareerde assets, %selector%-scoping, standaardwaarden voor velden en grenzen voor herhalingen.
extreme-theme
PHPStan max, ge-escape’te uitvoer, geen externe shellopdrachten, geldige Tailwind-klassen en schone JavaScript.
wordpress-render
Extreme-thema plus een live WordPress-renderprobe die je zelf aanlevert. Deze werkt zonder shell, en een mislukte render wordt als bevinding gemeld.
Twig, Blade en scripts
Twig, Blade en bloktags worden gecontroleerd aan de hand van dezelfde velden. De extreme-laag controleert ook JavaScript en Interactivity-directives aan de hand van je markup en stores.
Bestaande projecten
Een PHPStan-baseline houdt geregistreerde bevindingen tegen terwijl nieuwe code aan de volledige preset voldoet. blockstudioScanRoots leest blokbibliotheken buiten de hoofdmap, en meegeleverde stubs typeren de openbare API.
Inventarisatie en rendering vanuit PHP
Met een paar aanroepen kan een agent zien wat een project registreert, elk onderdeel ervan renderen en controleren wat het heeft opgeslagen.
Stel vragen over het project en geef het antwoord weer
Canvas::inventory() geeft elke geregistreerde pagina, elk blok, patroon, Site Editor-template, templateonderdeel en UI-voorbeeld van een project terug, zonder iets te renderen.
Render::document() rendert elk ervan als een volledig HTML-document met precies de gebruikte assets, zodat een agent het resultaat buiten de editor kan controleren.
Canvas::documents() rendert precies de records die je selecteert. Render::composition() en Render::content() geven geneste declaraties of geserialiseerde blokinhoud terug als HTML, en Ui::inventory() en Ui::examples() tonen de meegeleverde componentfamilies, elk met één renderbare declaratie.
Voor één blok geven bs_block_fields(), bs_block_extension_fields(), bs_block_values() en bs_block_assets() de velden, waarden en assets terug zonder het blok te renderen, en bs_validate_block() controleert opgeslagen attributen voordat je ze opslaat.
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=jsonMinder dan de helft van de tokens per pagina
Agents schrijven gewone HTML. Blockstudio zet dit bij synchronisatie om in geserialiseerde WordPress-blokopmaak: minder om te genereren en minder kans op fouten.
Blockstudio
Wat agents schrijven
<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
Wat de parser ervoor schrijft
<!-- 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 -->Gemeten aan de twee panelen hierboven: 540 tekens aan HTML tegenover de 1,233 tekens aan blokmarkup die de standaardparser ervoor schrijft, gedeeld door vier, de gebruikelijke schatting van het aantal tekens per token. De markup wordt weergegeven met regeleinden voor de leesbaarheid.
Minder uitvoer om te genereren
Agents schrijven HTML zonder blokscheidingstekens, gegenereerde klassen of wrapperopmaak.
Minder kans op fouten
De parser garandeert geldige blokuitvoer op basis van de eenvoudigere invoer.
Sneller en goedkoper
Minder uitvoertokens betekent snellere antwoorden en lagere modelkosten.
Werkt met elke AI-codeertool
Elke agent die bestanden kan lezen en schrijven, werkt direct met Blockstudio.
Gebouwd voor de AI-workflow
Blokken, pagina’s, patronen, instellingen. Alles is een bestand dat een agent kan lezen, schrijven en aanpassen.
Twee bestanden per blok
Een JSON-configuratie en een template vormen het hele blok. Dankzij het kleine oppervlak is generatie in één keer betrouwbaar.
27 veldtypen
Tekst, bestanden, herhalingen, kleuren, datums en meer, gedefinieerd in JSON. Keuzelijsten vullen zich met berichten, termen en gebruikers.
JSON-schemavalidatie
Elke configuratie heeft een schema met exacte regels voor agents en dat fouten meteen opspoort.
Automatische registratie
Plaats bestanden in een map en blokken worden automatisch geregistreerd, zonder extra configuratielijst.
Canvasoverzicht
Elke beheerde pagina, of elk blok met standaardwaarden, in één in- en uitzoombeeld.
Live canvas
De live modus vernieuwt de betreffende artboards via Server-Sent Events ongeveer een seconde nadat je iets hebt opgeslagen. Klik op een label om een artboard te focussen.
Tailwind ingebouwd
TailwindPHP compileert de klassen die elke pagina gebruikt, zonder Node-configuratie.
Element Grabber
Kopieer het templatepad en de opmaak van een element als directe context voor een agent.
HTML naar blokken
Pagina’s en patronen zijn gewone bestanden die native WordPress-blokken worden.
Render-smoketest
wp bs blocks render rendert elk blok zoals een pagina dat doet en stopt met code 1 als een sjabloon een notice, waarschuwing of fout veroorzaakt.
Controles van opgeslagen inhoud
wp bs blocks validate controleert de opgeslagen velden van berichten, en pages sync waarschuwt voor attributen die een blok opslaat maar nooit rendert.
Inspecteer vanuit de terminal
Geef instellingen, aangepaste velden en assets weer met wp bs, en compileer een fragment of bestand met wp bs tailwind compile of wp bs scss compile.
De officiële uitbreidingskit
Premium-sitetemplates, AI-systeeminstructies en een privécommunity van Discord. Eenmalige aankoop, levenslange updates.
- 500+ websitesjablonen
- Systeeminstructies voor AI
- Updates voor altijd
- Privécommunity van Discord