Preskoči na vsebino

Razvoj blokov, zasnovan za UI

Datoteke brez koraka gradnje – prav to agenti obvladajo.

Nemi posnetek zaslona: kodirni agent iz enega samega poziva zgradi celotno spletno mesto WordPress z 10 bloki po meri in 6 stranmi.

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

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.

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.

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

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

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.

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

Manj 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

Približno 135 žetonov
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

Kaj zapiše razčlenjevalnik

Približno 310 žetonov
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 -->

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.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

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.

Plus

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