Razvoj blokov, zasnovan za UI
Datoteke brez koraka gradnje – prav to agenti obvladajo.
Opišite blok, dobite blok
Agenti za kodiranje z UI lahko iz enega poziva pripravijo ogrodje blokov, strani in vzorcev. Brez grafičnega vmesnika in podatkovne zbirke, samo datoteke.
~/starter-theme
❯ Ustvari blok za cene s tremi paketi, preklopom med mesečnim in letnim obračunom ter pozivom k dejanju za vsak paket.
✓ Ustvarjeno pricing/block.json
✓ Ustvarjeno pricing/index.php
✓ Ustvarjeno pricing/style.css
❯ Zdaj ustvari stran s cenami z uvodnim razdelkom in razdelkom s pogostimi vprašanji.
✓ Ustvarjeno pages/pricing/page.json
✓ Ustvarjeno pages/pricing/index.php
Datoteke
blockstudio/
├── pricing/ Novo
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Novo
├── page.json
└── index.php
Vse temelji na datotekah
Bloki, strani, vzorci in razširitve so imeniki s konfiguracijo JSON in predlogami. Agenti jih lahko izvorno berejo in zapisujejo.
Brez konfiguracije zbirke podatkov
Ni treba klikati po skrbniških ploščah. Vsaka nastavitev je ključ JSON, zato lahko agent pripravi knjižnico brez brskalnika.
Predvidljiva struktura
Vsi bloki sledijo enakemu vzorcu: block.json, predloga in izbirni slogi. Vzorec se naučite le enkrat.
Kontekst namesto ugibanja
Strnjeno kazalo dokumentacije in celotno besedilo za orodja, ki ga potrebujejo v celoti.
Kazalo, ki ga agent najprej prebere
blockstudio-llm.txt enkrat navede vsak dokument, njegovo pot, izvorno datoteko, namen ter nastavitve, kljuke, funkcije PHP in ukaze CLI, ki jim pripadajo. Pri približno 11k žetonih ga agent prebere v celoti, nato pa odpre le stran, ki jo potrebuje.
blockstudio-llm-full.txt v eni datoteki vsebuje vse dokumente in shemo JSON, približno 169k žetonov, za orodja, ki potrebujejo celoten korpus. Vklopite ai.enableContextGeneration in vaše spletno mesto ponuja oboje.
# 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.Pogodba za vaš projekt
Dokumentacija opisuje Blockstudio. AGENTS.md opisuje projekt, ki ga bo agent spremenil.
En ukaz zapiše AGENTS.md
vendor/bin/blockstudio-agents opisuje projekt, v katerem se izvaja: kaj vsebuje, katere funkcije omogoča blockstudio.json, kaj bo analiza zavrnila in kateri ukazi veljajo.
Vsaka vrstica izhaja iz vaših datotek, nastavitev ali izbrane prednastavitve analize. Pri ponovnem ustvarjanju ostanejo ročno zapisane opombe, --check pa ne uspe, če pogodba ni več veljavna.
# 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 --checkNapake odkrite pred potrditvijo
Štiri prednastavitve analize, pri čemer vsaka vključuje vse možnosti prejšnje, in kljuka, ki jih zažene ob vsaki potrditvi sprememb.
Analiza, ki pozna block.json
Prednastavitve blockstudio/phpstan pregledajo vaše bloke, strani in nastavitve. Analiza ne uspe, če predloga bere polje, ki ga njen block.json ni nikoli deklariral, ali ga izpiše brez ubežanja.
Predloge berejo $a, katerega tipi izhajajo iz block.json poleg njih; za vsako vrsto polja je na voljo konkreten tip PHP, Db::get() pa vrne zapise v obliki, določeni z db.php. Ob napačno črkovani poti nastavitev ali imenu kavlja se predlaga najbližje pravo ime.
Nastavite githooks.commit in zaženite vendor/bin/blockstudio-githooks sync: upravljana kljuka pred potrditvijo zažene enako analizo, zato pokvarjen blok nikoli ne pride v potrditev.
{
"$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
Vsak ključ $a, ki ga bere predloga, obstaja v block.json; kljuke, poti nastavitev in oznake blokov so dejanske.
theme
Glave tem, deklarirana sredstva, omejevanje obsega z %selector%, privzete vrednosti polj in omejitve ponavljalnikov.
extreme-theme
Največ PHPStan, ubežni izhod, brez klicanja lupine, veljavni razredi Tailwind in čisti JavaScript.
wordpress-render
Tema Extreme in preizkus izrisa v živo z WordPress, ki ga zagotovite sami. Deluje brez lupine, neuspešen izris pa se zabeleži kot ugotovitev.
Twig, Blade in skripte
Twig, Blade in oznake blokov se preverjajo glede na ista polja. Plast Extreme preverja tudi JavaScript in direktive Interactivity glede na vašo označevalno kodo in shranjene podatke.
Obstoječi projekti
Izhodišče PHPStan zadrži zabeležene ugotovitve, medtem ko mora nova koda izpolnjevati celoten prednastavljeni nabor pravil. blockstudioScanRoots bere knjižnice blokov zunaj korenske mape, priložene nadomestne definicije pa tipizirajo javni API.
Popis in izris iz PHP
Z nekaj klici lahko agent preveri, kaj projekt registrira, izriše poljuben njegov del in ugotovi, kaj je shranil.
Vprašajte projekt, izrišite odgovor
Canvas::inventory() vrne vsako stran, blok, vzorec, predlogo urejevalnika spletnega mesta, del predloge in primer UI, ki ga projekt registrira, ne da bi karkoli izrisal.
Render::document() izriše poljuben element kot celoten dokument HTML z natanko tistimi sredstvi, ki jih je uporabil, tako da lahko agent preveri svoje delo zunaj urejevalnika.
Canvas::documents() izriše natanko tiste zapise, ki jih izberete. Render::composition() in Render::content() vrneta ugnezdene deklaracije ali serializirano vsebino bloka kot HTML, Ui::inventory() in Ui::examples() pa naštejeta družine priloženih komponent, vsako z eno deklaracijo, ki jo je mogoče izrisati.
Za posamezen blok bs_block_fields(), bs_block_extension_fields(), bs_block_values() in bs_block_assets() vrnejo njegova polja, vrednosti in sredstva, ne da bi ga izrisali, bs_validate_block() pa pred shranjevanjem preveri shranjene atribute.
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=jsonManj kot polovica žetonov na stran
Agenti pišejo navaden HTML. Blockstudio ga pri sinhronizaciji pretvori v serializirane oznake blokov WordPress: manj je treba ustvariti in manj se lahko zalomi.
Blockstudio
Kaj napišejo agenti
<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
Kaj zapiše razčlenjevalnik
<!-- 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 -->Izmerjeno na zgornjih dveh ploščah: 540 znakov HTML v primerjavi z 1,233 znaki označevalne kode bloka, ki jo zapiše standardni razčlenjevalnik; deljeno s štiri, običajno oceno števila znakov na žeton. Označevalna koda je prikazana z dodanimi prelomi vrstic za lažje branje.
Manj ustvarjenega izhoda
Agenti pišejo HTML brez ločil blokov, ustvarjenih razredov ali ovojnih oznak.
Manj možnosti za napake
Razčlenjevalnik iz preprostejšega vhoda zagotovi veljaven izhod blokov.
Hitreje in ceneje
Manj izhodnih žetonov pomeni hitrejše odgovore in nižje stroške modela.
Deluje z vsakim orodjem za programiranje z UI
Vsak agent, ki zna brati in zapisovati datoteke, deluje z Blockstudio takoj po namestitvi.
Ustvarjeno za potek dela z UI
Bloki, strani, vzorci, nastavitve. Vse je datoteka, ki jo agent lahko bere, zapisuje in spreminja.
Dve datoteki na blok
Blok v celoti sestavljata konfiguracija JSON in predloga. Majhen obseg omogoča zanesljivo generiranje že v prvem poskusu.
27 vrst polj
Besedilo, datoteke, ponavljalniki, barve, datumi in drugo, določeno v JSON. Izbirna polja se napolnijo z objavami, izrazi in uporabniki.
Preverjanje sheme JSON
Vsaka konfiguracija ima shemo, ki agentom poda natančna pravila in takoj zazna napake.
Samodejna registracija
Datoteke dodajte v imenik in bloki se registrirajo samodejno, brez dodatnega seznama konfiguracij.
Pregled platna
Vse upravljane strani ali vsi bloki s privzetimi vrednostmi v enem pogledu s spreminjanjem povečave.
Platno v živo
Način v živo približno sekundo po shranjevanju osveži prizadete risalne površine prek Server-Sent Events. Kliknite oznako, da se osredotočite na eno risalno površino.
Vgrajeno v Tailwind
TailwindPHP prevede razrede, ki jih uporablja posamezna stran, brez konfiguracije Node.js.
Element Grabber
Kopirajte pot predloge in oznake elementa, da agentu takoj zagotovite kontekst.
HTML v bloke
Strani in vzorci so navadne datoteke, ki postanejo izvorni bloki WordPress.
Preizkusni izris
Ukaz wp bs blocks render izriše vsak blok tako kot stran in se konča s kodo 1, če predloga sproži obvestilo, opozorilo ali napako.
Preverjanje shranjene vsebine
Ukaz wp bs blocks validate preveri shranjena polja objav, ukaz pages sync pa opozori na atribute, ki jih blok shrani, vendar jih nikoli ne izriše.
Pregled v terminalu
Z ukazom wp bs naštejte nastavitve, polja po meri in sredstva, z ukazoma wp bs tailwind compile ali wp bs scss compile pa prevedite delček kode ali datoteko.
Uradni komplet razširitev
Vrhunske predloge spletnih mest, sistemska navodila za UI in zasebna skupnost Discord. Enkratni nakup, posodobitve za vedno.
- Več kot 500+ predlog spletnih mest
- Sistemska navodila za UI
- Doživljenjske posodobitve
- Zasebna skupnost Discord