Pengembangan blok AI-native
Berkas dan tanpa proses build, sesuai keahlian agent.
Jelaskan sebuah blok, dapatkan sebuah blok
Agen coding AI dapat membuat kerangka blok, halaman, dan pola dari satu prompt. Tanpa GUI dan database, hanya berkas.
~/starter-theme
❯ Buat blok harga dengan tiga tingkat, tombol bulanan/tahunan, dan CTA untuk setiap tingkat.
✓ Dibuat pricing/block.json
✓ Dibuat pricing/index.php
✓ Dibuat pricing/style.css
❯ Sekarang buat halaman harga dengan bagian hero dan FAQ.
✓ Dibuat pages/pricing/page.json
✓ Dibuat pages/pricing/index.php
File
blockstudio/
├── pricing/ Baru
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Baru
├── page.json
└── index.php
Semuanya berbasis berkas
Blok, halaman, pola, dan ekstensi berupa direktori dengan konfigurasi dan templat JSON. Agent membaca dan menulisnya secara langsung.
Tanpa konfigurasi basis data
Tak perlu mengeklik panel admin. Setiap pengaturan adalah kunci JSON, jadi agent dapat membuat kerangka pustaka tanpa browser.
Struktur yang konsisten
Setiap blok mengikuti konvensi yang sama: block.json, sebuah templat, dan gaya opsional. Pelajari polanya sekali.
Konteks, bukan tebakan
Indeks dokumentasi yang ringkas, beserta teks lengkap untuk alat yang membutuhkannya.
Indeks yang dibaca agent terlebih dahulu
blockstudio-llm.txt mencantumkan setiap dokumen satu kali, lengkap dengan rute, berkas sumber, tujuan, serta pengaturan, hook, fungsi PHP, dan perintah CLI yang dimilikinya. Dengan sekitar 11k token, agent membacanya sekaligus, lalu membuka hanya halaman yang diperlukan.
blockstudio-llm-full.txt memuat setiap dokumen dan skema JSON dalam satu berkas, sekitar 169k token, untuk alat yang membutuhkan seluruh kumpulan. Aktifkan ai.enableContextGeneration agar situs Anda menyajikan keduanya.
# 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.Kontrak untuk proyek Anda
Dokumentasi menjelaskan Blockstudio. AGENTS.md menjelaskan proyek yang akan diubah oleh agent.
Satu perintah menulis AGENTS.md
vendor/bin/blockstudio-agents menjelaskan proyek tempatnya berjalan: isi proyek, fitur yang diaktifkan blockstudio.json, hal yang akan ditolak analisis, dan perintah yang berlaku.
Setiap baris berasal dari berkas, pengaturan, atau preset analisis yang dipilih. Membuat ulang tetap mempertahankan catatan tulisan tangan Anda, dan --check gagal jika kontraknya sudah usang.
# 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 --checkKesalahan ditemukan sebelum commit
Empat preset analisis, masing-masing mencakup preset sebelumnya, serta hook yang menjalankannya pada setiap commit.
Analisis yang memahami block.json
Preset blockstudio/phpstan membaca blok, halaman, dan pengaturan Anda. Templat yang membaca field yang tidak pernah dideklarasikan oleh block.json, atau menampilkannya tanpa escape, akan gagal dianalisis.
Templat membaca $a bertipe dari block.json di sebelahnya, dengan tipe PHP konkret untuk setiap tipe field, dan Db::get() mengembalikan rekaman dengan bentuk yang ditentukan oleh db.php. Jalur pengaturan atau nama hook yang salah eja akan gagal dengan saran nama valid yang paling mirip.
Atur githooks.commit dan jalankan vendor/bin/blockstudio-githooks sync: hook pre-commit terkelola menjalankan analisis yang sama, sehingga blok yang rusak tidak pernah masuk ke 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
Setiap kunci $a yang dibaca templat tersedia di block.json; hook, jalur pengaturan, dan tag blok benar-benar ada.
theme
Header tema, aset yang dideklarasikan, cakupan %selector%, nilai default field, dan batas repeater.
extreme-theme
Batas maksimum PHPStan, output yang di-escape, tanpa menjalankan shell, kelas Tailwind yang valid, dan JavaScript yang bersih.
wordpress-render
Tema Extreme ditambah probe render WordPress langsung yang Anda sediakan. Ini berjalan tanpa shell, dan render yang gagal menjadi temuan.
Twig, Blade, dan skrip
Twig, Blade, dan tag blok diperiksa berdasarkan field yang sama. Lapisan Extreme juga membaca JavaScript dan direktif Interactivity berdasarkan markup dan penyimpanan Anda.
Proyek yang sudah ada
Baseline PHPStan menahan temuan yang tercatat sementara kode baru memenuhi preset lengkap. blockstudioScanRoots membaca pustaka blok di luar root, dan stub yang disertakan memberi tipe untuk API publik.
Inventaris dan rendering dari PHP
Beberapa pemanggilan memungkinkan agen melihat apa yang didaftarkan sebuah proyek, merender bagian mana pun darinya, dan memeriksa data yang disimpannya.
Tanyakan proyek, tampilkan jawabannya
Canvas::inventory() mengembalikan setiap halaman, blok, pola, templat Site Editor, bagian templat, dan contoh UI yang didaftarkan proyek, tanpa merender apa pun.
Render::document() merendernya sebagai dokumen HTML lengkap dengan aset yang benar-benar digunakannya, sehingga agent dapat memeriksa hasilnya di luar editor.
Canvas::documents() merender persis rekaman yang Anda pilih. Render::composition() dan Render::content() mengembalikan deklarasi bertingkat atau konten blok berserialisasi sebagai HTML, sedangkan Ui::inventory() dan Ui::examples() mencantumkan keluarga komponen bawaan dengan satu deklarasi yang dapat dirender untuk tiap keluarga.
Untuk satu blok, bs_block_fields(), bs_block_extension_fields(), bs_block_values(), dan bs_block_assets() mengembalikan field, nilai, dan asetnya tanpa merendernya, sedangkan bs_validate_block() memeriksa atribut tersimpan sebelum Anda menyimpannya.
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=jsonToken per halaman kurang dari setengah
Agent menulis HTML biasa. Saat sinkronisasi, Blockstudio mengubahnya menjadi markup blok WordPress serialisasi: lebih sedikit yang perlu dibuat dan lebih sedikit peluang salah.
Blockstudio
Yang ditulis agen
<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
Yang ditulis parser untuk membuatnya
<!-- 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 -->Diukur dari dua panel di atas: 540 karakter HTML dibandingkan dengan 1,233 karakter markup blok yang ditulis parser bawaan untuknya, lalu dibagi empat, perkiraan umum jumlah karakter per token. Markup ditampilkan dengan pemisah baris agar mudah dibaca.
Lebih sedikit output untuk dibuat
Agent menulis HTML tanpa pembatas blok, kelas yang dihasilkan, atau markup pembungkus.
Lebih sedikit peluang salah
Parser menjamin output blok yang valid dari input yang lebih sederhana.
Lebih cepat dan hemat
Token output yang lebih sedikit berarti respons lebih cepat dan biaya model lebih rendah.
Kompatibel dengan setiap alat coding AI
Agent apa pun yang dapat membaca dan menulis berkas bisa langsung menggunakan Blockstudio.
Dirancang untuk alur kerja AI
Blok, halaman, pola, pengaturan. Semuanya berupa berkas yang dapat dibaca, ditulis, dan diubah oleh agent.
Dua berkas per blok
Konfigurasi JSON dan templat sudah mencakup seluruh blok. Permukaan yang kecil membuat pembuatan pada percobaan pertama andal.
27 jenis field
Teks, berkas, repeater, warna, tanggal, dan lainnya ditentukan di JSON. Opsi pilihan mengambil data dari post, term, dan pengguna.
Validasi skema JSON
Setiap konfigurasi memiliki skema yang memberi agent aturan pasti dan langsung mendeteksi kesalahan.
Pendaftaran otomatis
Letakkan berkas di direktori dan blok akan didaftarkan otomatis, tanpa daftar konfigurasi tambahan.
Ikhtisar kanvas
Setiap halaman yang dikelola, atau setiap blok beserta nilai default-nya, dalam satu tampilan yang dapat diperbesar.
Kanvas langsung
Mode langsung memperbarui artboard yang terdampak melalui Server-Sent Events sekitar satu detik setelah penyimpanan. Klik label untuk memfokuskan satu artboard.
Tailwind bawaan
TailwindPHP mengompilasi kelas yang digunakan tiap halaman, tanpa konfigurasi Node.
Element Grabber
Salin jalur templat dan markup suatu elemen sebagai konteks langsung untuk agent.
HTML menjadi blok
Halaman dan pola adalah berkas biasa yang menjadi blok WordPress bawaan.
Uji render singkat
wp bs blocks render merender setiap blok seperti pada halaman dan keluar dengan kode 1 saat templat memunculkan notice, warning, atau error.
Pemeriksaan konten tersimpan
wp bs blocks validate memeriksa field tersimpan pada pos, dan pages sync memperingatkan tentang atribut yang disimpan blok tetapi tidak pernah dirender.
Periksa dari terminal
Cantumkan pengaturan, field khusus, dan aset dengan wp bs, lalu kompilasi cuplikan atau file dengan wp bs tailwind compile atau wp bs scss compile.
Kit ekstensi resmi
Template situs premium, instruksi sistem AI, dan komunitas Discord privat. Pembelian satu kali, pembaruan seumur hidup.
- 500+ templat situs
- Instruksi sistem AI
- Pembaruan seumur hidup
- Komunitas privat Discord