# AI-native blokontwikkeling

Bestanden en geen buildstap: precies waar agents goed in zijn.

[Documentatie lezen](https://blockstudio.dev/nl/docs/dev/ai/)

Een stille schermopname: een codeeragent bouwt met één prompt een complete WordPress-site met 10 aangepaste blokken en 6 pagina’s.

## 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.

[Documentatie voor AI-integratie](https://blockstudio.dev/nl/docs/dev/ai/)

blockstudio-llm.txt

```
# 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.

[Projectcontract](https://blockstudio.dev/nl/docs/dev/phpstan/#project-contract-for-coding-agents)

AGENTS.md

```
# 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.
```

## Fouten 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.

[Analysepresetten](https://blockstudio.dev/nl/docs/dev/phpstan/#analysis-presets)

blockstudio.json

```
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "phpstan": { "preset": "extreme-theme" },
  "githooks": { "commit": true }
}
```

## [base](https://blockstudio.dev/nl/docs/dev/phpstan/#analysis-presets)

Elke $a-sleutel die een template leest, bestaat in block.json; hooks, instellingpaden en bloktags zijn echt.

## [theme](https://blockstudio.dev/nl/docs/dev/phpstan/#analysis-presets)

Themakoppen, gedeclareerde assets, %selector%-scoping, standaardwaarden voor velden en grenzen voor herhalingen.

## [extreme-theme](https://blockstudio.dev/nl/docs/dev/phpstan/#analysis-presets)

PHPStan max, ge-escape’te uitvoer, geen externe shellopdrachten, geldige Tailwind-klassen en schone JavaScript.

## [wordpress-render](https://blockstudio.dev/nl/docs/dev/phpstan/#live-wordpress-rendering)

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](https://blockstudio.dev/nl/docs/dev/phpstan/#what-it-checks)

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](https://blockstudio.dev/nl/docs/dev/phpstan/#adopting-analysis-on-an-existing-project)

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.

[Programmatisch renderen](https://blockstudio.dev/nl/docs/blocks/rendering/#structured-compositions-and-complete-documents)

inspect.php

```
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']);
```

## Minder 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

Ongeveer 135 tokens

index.php

```
<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

Ongeveer 310 tokens

post_content

```
<!-- 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.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

## 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.

Plus

## 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

[Neem Plus](https://blockstudio.dev/nl/plus/)
