AI-anpassad blockutveckling
Filer och inget byggsteg – sådant agenter är bra på.
Beskriv ett block, få ett block
AI-kodningsagenter kan skapa grundstrukturen för block, sidor och mönster utifrån en enda prompt. Inget GUI och ingen databas, bara filer.
~/starter-theme
❯ Skapa ett prisblock med tre nivåer, en växling mellan månads- och årsbetalning och en CTA för varje nivå.
✓ Skapad pricing/block.json
✓ Skapad pricing/index.php
✓ Skapad pricing/style.css
❯ Skapa nu en prissida med en hero och en FAQ-sektion.
✓ Skapad pages/pricing/page.json
✓ Skapad pages/pricing/index.php
Filer
blockstudio/
├── pricing/ Ny
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Ny
├── page.json
└── index.php
Allt filbaserat
Block, sidor, mönster och tillägg är mappar med JSON-konfiguration och mallar. Agenter kan läsa och skriva i dem direkt.
Ingen databaskonfiguration
Inga adminpaneler att klicka sig igenom. Varje inställning är en JSON-nyckel, så en agent kan skapa bibliotekets grundstruktur utan webbläsare.
Förutsägbar struktur
Varje block följer samma mönster: block.json, en mall och valfria stilar. Lär dig mönstret en gång.
Sammanhang, inte gissningar
Ett kompakt dokumentationsindex plus hela texten för verktyg som vill ha allt.
Ett index som agenten läser först
blockstudio-llm.txt listar varje dokument en gång med dess rutt, källfil, syfte och de inställningar, hooks, PHP-funktioner och CLI-kommandon som det hanterar. Med cirka 11k tokens kan en agent läsa hela indexet och sedan bara öppna sidan den behöver.
blockstudio-llm-full.txt samlar alla dokument och JSON-scheman i en fil på cirka 169k tokens, för verktyg som vill ha hela materialet. Aktivera ai.enableContextGeneration så visar webbplatsen båda.
# 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.Ett kontrakt för ditt projekt
Dokumentationen beskriver Blockstudio. AGENTS.md beskriver projektet som agenten snart ska ändra.
Ett kommando skapar AGENTS.md
vendor/bin/blockstudio-agents beskriver projektet som det körs i: vad det innehåller, vilka funktioner blockstudio.json aktiverar, vad analysen underkänner och vilka kommandon som gäller.
Varje rad hämtas från dina filer, inställningar eller den valda analysprofilen. När du återskapar filen bevaras anteckningar du skrivit för hand, och --check misslyckas om kontraktet är inaktuellt.
# 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 --checkMisstag upptäcks före commit
Fyra analysförinställningar, där varje efterföljande innehåller den föregående, och en hook som kör dem vid varje commit.
Analys som känner till block.json
Profilerna för blockstudio/phpstan läser dina block, sidor och inställningar. Analysen underkänner en mall som läser ett fält som dess block.json aldrig deklarerat eller skriver ut o-escapat.
Mallar läser en typad $a från block.json bredvid dem, med en konkret typ för PHP för varje fälttyp, och Db::get() returnerar poster formade enligt db.php. En felstavad sökväg till inställningar eller ett felstavat hooknamn ger ett felmeddelande med förslag på det närmaste giltiga namnet.
Ange githooks.commit och kör vendor/bin/blockstudio-githooks sync: den hanterade pre-commit-hooken kör samma analys, så ett trasigt block når aldrig en 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
Varje $a-nyckel som en mall läser finns i block.json; hooks, inställningssökvägar och blocktaggar är verkliga.
theme
Temarubriker, deklarerade resurser, %selector%-avgränsning, fältstandardvärden och gränser för upprepningsfält.
extreme-theme
PHPStan max, escapad utdata, inga externa shellkommandon, giltiga Tailwind-klasser och ren JavaScript.
wordpress-render
Extreme theme samt en live-renderingsprob för WordPress som du tillhandahåller. Den körs utan ett skal, och en misslyckad rendering blir ett fynd.
Twig, Blade och skript
Twig, Blade och blocktaggar kontrolleras mot samma fält. Extreme-lagret läser också JavaScript och Interactivity-direktiv mot din markup och dina lagrar.
Befintliga projekt
En baslinje för PHPStan håller tillbaka registrerade fynd medan ny kod uppfyller hela den förinställda konfigurationen. blockstudioScanRoots läser blockbibliotek utanför roten, och de medföljande stubbarna typbestämmer det publika API.
Inventering och rendering från PHP
Med några få anrop kan en agent se vad ett projekt registrerar, rendera valfri del av det och kontrollera vad det har sparat.
Fråga projektet, visa svaret
Canvas::inventory() returnerar varje sida, block, mönster, mall i Site Editor, malldel och UI-exempel som projektet registrerar, utan att rendera något.
Render::document() renderar valfritt objekt som ett komplett HTML-dokument med exakt de resurser det använde, så att en agent kan granska sitt arbete utanför redigeraren.
Canvas::documents() renderar exakt de poster du väljer. Render::composition() och Render::content() returnerar nästlade deklarationer eller serialiserat blockinnehåll som HTML, och Ui::inventory() och Ui::examples() listar de medföljande komponentfamiljerna med en renderbar deklaration var.
För ett block returnerar bs_block_fields(), bs_block_extension_fields(), bs_block_values() och bs_block_assets() dess fält, värden och resurser utan att rendera det, och bs_validate_block() kontrollerar lagrade attribut innan du sparar dem.
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=jsonMindre än hälften så många tokens per sida
Agenter skriver vanlig HTML. Vid synkronisering omvandlar Blockstudio det till serialiserad blockuppmärkning i WordPress: mindre att generera och mindre risk för fel.
Blockstudio
Vad agenterna skriver
<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
Vad parsern skriver för det
<!-- 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 -->Uppmätt på de två panelerna ovan: 540 tecken från HTML jämfört med 1,233 tecken blockmarkup som standardparsern skriver för det, dividerat med fyra, den vanliga uppskattningen av antal tecken per token. Markupen visas med tillagda radbrytningar för läsbarhet.
Mindre utdata att generera
Agenter skriver HTML utan blockavgränsare, genererade klasser eller omslutande uppmärkning.
Mindre risk för fel
Parsern garanterar giltig blockutdata från den enklare inmatningen.
Snabbare och billigare
Färre utdata-token ger snabbare svar och lägre modellkostnader.
Fungerar med alla AI-kodningsverktyg
Alla agenter som kan läsa och skriva filer fungerar med Blockstudio direkt.
Byggt för AI-arbetsflödet
Block, sidor, mönster, inställningar. Allt är en fil som en agent kan läsa, skriva i och ändra.
Två filer per block
En JSON-konfiguration och en mall utgör hela blocket. Det lilla omfånget gör första generationen tillförlitlig.
27 fälttyper
Text, filer, upprepningsfält, färger, datum och mer definieras i JSON. Väljlistor fylls med inlägg, termer och användare.
Validering av JSON-schema
Varje konfiguration har ett schema som ger agenter exakta regler och upptäcker misstag direkt.
Automatisk registrering
Lägg filer i en mapp så registreras blocken automatiskt, utan någon extra konfigurationslista.
Översikt över arbetsytan
Varje hanterad sida, eller varje block med sina standardvärden, i en enda vy som går att zooma.
Live-arbetsyta
Live-läget uppdaterar berörda ritytor via Server-Sent Events ungefär en sekund efter att du sparat. Klicka på en etikett för att fokusera på en rityta.
Inbyggt i Tailwind
TailwindPHP kompilerar klasserna som varje sida använder, utan Node-konfiguration.
Element Grabber
Kopiera en elements mallsökväg och uppmärkning för att ge en agent omedelbar kontext.
HTML till block
Sidor och mönster är vanliga filer som blir inbyggda WordPress-block.
Röktest för rendering
wp bs blocks render renderar varje block som en sida gör och avslutas med 1 när en mall ger ett meddelande, en varning eller ett fel.
Kontroller av lagrat innehåll
wp bs blocks validate kontrollerar sparade fält i inlägg, och pages sync varnar för attribut som ett block lagrar men aldrig renderar.
Granska från terminalen
Lista inställningar, anpassade fält och resurser med wp bs, och kompilera ett kodavsnitt eller en fil med wp bs tailwind compile eller wp bs scss compile.
Det officiella tilläggspaketet
Premiumwebbplatsmallar, systeminstruktioner för AI och en privat Discord-community. Engångsköp, uppdateringar på livstid.
- 500+ webbplatsmallar
- AI-systeminstruktioner
- Uppdateringar livet ut
- Privat Discord-community