# AI-anpassad blockutveckling

Filer och inget byggsteg – sådant agenter är bra på.

[Läs dokumentationen](https://blockstudio.dev/sv/docs/dev/ai/)

En ljudlös skärminspelning: en kodningsagent bygger en komplett WordPress-webbplats med 10 anpassade block och 6 sidor utifrån en enda prompt.

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

[Dokumentation för AI-integration](https://blockstudio.dev/sv/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.
```

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

[Projektkontrakt](https://blockstudio.dev/sv/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.
```

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

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

blockstudio.json

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

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

Varje $a-nyckel som en mall läser finns i block.json; hooks, inställningssökvägar och blocktaggar är verkliga.

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

Temarubriker, deklarerade resurser, %selector%-avgränsning, fältstandardvärden och gränser för upprepningsfält.

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

PHPStan max, escapad utdata, inga externa shellkommandon, giltiga Tailwind-klasser och ren JavaScript.

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

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

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

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.

[Programmatisk rendering](https://blockstudio.dev/sv/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']);
```

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

Cirka 135 token

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

Vad parsern skriver för det

Cirka 310 token

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

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.

Claude Code

Codex CLI

Gemini CLI

Cursor

Windsurf

Amp

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

Plus

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

[Skaffa Plus](https://blockstudio.dev/sv/plus/)
