Lewati ke konten

Pengembangan blok AI-native

Berkas dan tanpa proses build, sesuai keahlian agent.

Rekaman layar tanpa suara: agen coding membangun situs WordPress lengkap dengan 10 blok kustom dan 6 halaman dari satu prompt.

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

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.

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.

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

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

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.

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

Token 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

Sekitar 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

Yang ditulis parser untuk membuatnya

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

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.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

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.

Plus

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