Desenvolvimento de blocos nativo para IA
Arquivos e nenhuma etapa de build: exatamente o que os agentes fazem bem.
Descreva um bloco, receba um bloco
Agentes de programação com IA podem criar a estrutura de blocos, páginas e padrões com um único prompt. Sem interface gráfica nem banco de dados: apenas arquivos.
~/starter-theme
❯ Crie um bloco de preços com três níveis, uma alternância entre mensal e anual e uma CTA para cada nível.
✓ Criado em pricing/block.json
✓ Criado em pricing/index.php
✓ Criado em pricing/style.css
❯ Agora crie uma página de preços com uma seção principal e uma de perguntas frequentes.
✓ Criado em pages/pricing/page.json
✓ Criado em pages/pricing/index.php
Arquivos
blockstudio/
├── pricing/ Novo
├── block.json
├── index.php
└── style.css
pages/
├── pricing/ Novo
├── page.json
└── index.php
Tudo baseado em arquivos
Blocos, páginas, padrões e extensões são diretórios com configurações e modelos JSON. Agentes leem e gravam neles nativamente.
Sem configuração de banco de dados
Sem painéis administrativos para navegar. Cada configuração é uma chave JSON, então um agente pode estruturar a biblioteca sem navegador.
Estrutura previsível
Todos os blocos seguem a mesma convenção: block.json, um modelo e estilos opcionais. Aprenda o padrão uma vez.
Contexto, sem suposições
Um índice compacto da documentação, além do texto completo para ferramentas que precisam de tudo.
Um índice que o agente lê primeiro
blockstudio-llm.txt lista cada documento uma vez, com sua rota, arquivo de origem, finalidade e as configurações, hooks, funções PHP e comandos CLI que ele possui. Com cerca de 11k tokens, um agente o lê por inteiro e abre apenas a página necessária.
blockstudio-llm-full.txt reúne todos os documentos e todos os esquemas JSON em um arquivo, com cerca de 169k tokens, para ferramentas que precisam do corpus completo. Ative ai.enableContextGeneration e seu site servirá ambos.
# 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.Um contrato para seu projeto
A documentação descreve Blockstudio. AGENTS.md descreve o projeto que o agente está prestes a alterar.
Um comando grava AGENTS.md
vendor/bin/blockstudio-agents descreve o projeto em que é executado: o que contém, quais recursos blockstudio.json habilita, o que a análise rejeitará e quais comandos se aplicam.
Cada linha vem dos seus arquivos, configurações ou da predefinição de análise selecionada. Gerar novamente preserva as notas escritas manualmente, e --check falha quando o contrato está desatualizado.
# 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 --checkErros detectados antes do commit
Quatro predefinições de análise, cada uma abrangendo a anterior, e um hook que as executa em cada commit.
Análise que conhece block.json
As predefinições blockstudio/phpstan leem seus blocos, páginas e configurações. Se um modelo lê um campo que seu block.json não declarou ou o exibe sem escape, a análise falha.
Os modelos leem um $a tipado a partir do block.json ao lado deles, com um tipo PHP específico para cada tipo de campo, e Db::get() retorna registros estruturados por db.php. Um caminho de configuração ou nome de hook digitado incorretamente gera um erro com sugestão do nome real mais próximo.
Configure githooks.commit e execute vendor/bin/blockstudio-githooks sync: o hook de pré-commit gerenciado executa a mesma análise, impedindo que um bloco com erros chegue ao 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
Toda chave $a lida por um modelo existe em block.json; hooks, caminhos de configurações e tags de bloco são reais.
theme
Cabeçalhos de tema, recursos declarados, escopo %selector%, valores padrão dos campos e limites de repetidores.
extreme-theme
Máximo PHPStan, saída escapada, sem execução de comandos no shell, classes Tailwind válidas e JavaScript limpo.
wordpress-render
Tema Extreme com uma sonda de renderização WordPress em tempo real fornecida por você. Ela é executada sem shell, e uma falha de renderização gera um apontamento.
Twig, Blade e scripts
Twig, Blade e as tags de bloco são verificados em relação aos mesmos campos. A camada Extreme também verifica JavaScript e as diretivas de Interactivity em relação à sua marcação e aos dados armazenados.
Projetos existentes
Uma linha de base PHPStan mantém os apontamentos registrados em espera enquanto o novo código atende ao preset completo. blockstudioScanRoots lê bibliotecas de blocos fora da raiz, e os stubs incluídos tipam a API pública API.
Inventário e renderização de PHP
Com algumas chamadas, um agente pode ver o que um projeto registra, renderizar qualquer parte dele e verificar o que foi armazenado.
Consulte o projeto e renderize a resposta
Canvas::inventory() retorna todas as páginas, blocos, padrões, modelos do Editor do site, partes de modelo e exemplos UI registrados por um projeto, sem renderizar nada.
Render::document() renderiza qualquer um deles como um documento HTML completo, incluindo exatamente os recursos utilizados, para que um agente possa verificar o trabalho fora do editor.
Canvas::documents() renderiza exatamente os registros que você seleciona. Render::composition() e Render::content() retornam declarações aninhadas ou conteúdo de bloco serializado como HTML, e Ui::inventory() e Ui::examples() listam as famílias de componentes incluídas, com uma declaração renderizável para cada uma.
Para um bloco, bs_block_fields(), bs_block_extension_fields(), bs_block_values() e bs_block_assets() retornam seus campos, valores e recursos sem renderizá-lo, e bs_validate_block() verifica os atributos armazenados antes que você os salve.
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=jsonMenos da metade dos tokens por página
Agentes escrevem HTML simples. Na sincronização, Blockstudio o transforma em marcação de bloco WordPress serializada: menos para gerar e menos chances de errar.
Blockstudio
O que os agentes escrevem
<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
O que o analisador escreve para isso
<!-- 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 -->Medição dos dois painéis acima: 540 caracteres de HTML, comparados aos 1,233 caracteres da marcação de bloco que o analisador padrão escreve para isso; o resultado é dividido por quatro, a estimativa habitual de caracteres por token. A marcação é exibida com quebras de linha para facilitar a leitura.
Menos saída para gerar
Agentes escrevem HTML sem delimitadores de bloco, classes geradas ou marcação de contêiner.
Menos chances de errar
O analisador garante uma saída de bloco válida a partir da entrada mais simples.
Mais rápido e econômico
Menos tokens de saída significam respostas mais rápidas e custos menores com modelos.
Compatível com todas as ferramentas de programação com IA
Qualquer agente capaz de ler e gravar arquivos funciona com Blockstudio imediatamente.
Feito para o fluxo de trabalho com IA
Blocos, páginas, padrões, configurações. Tudo é um arquivo que um agente pode ler, gravar e modificar.
Dois arquivos por bloco
Uma configuração JSON e um modelo compõem todo o bloco. A superfície reduzida torna confiável a geração na primeira tentativa.
27 tipos de campo
Texto, arquivos, repetidores, cores, datas e muito mais, definidos em JSON. As opções são preenchidas com publicações, termos e usuários.
Validação de esquema JSON
Toda configuração tem um esquema, que fornece regras exatas aos agentes e detecta erros imediatamente.
Registro automático
Coloque arquivos em um diretório e os blocos serão registrados automaticamente, sem outra lista de configurações.
Visão geral da tela
Todas as páginas gerenciadas, ou todos os blocos com seus valores padrão, em uma única visualização com zoom.
Tela de trabalho ao vivo
O modo ao vivo atualiza as pranchetas afetadas por Server-Sent Events cerca de um segundo após salvar. Clique em um rótulo para focar uma prancheta.
Tailwind integrado
TailwindPHP compila as classes usadas em cada página, sem configuração de Node.
Element Grabber
Copie o caminho do modelo e a marcação de um elemento para dar contexto imediato a um agente.
HTML para blocos
Páginas e padrões são arquivos simples que se tornam blocos WordPress nativos.
Teste rápido de renderização
wp bs blocks render renderiza cada bloco como uma página e encerra com 1 quando um modelo gera um aviso, uma advertência ou um erro.
Verificações de conteúdo armazenado
wp bs blocks validate verifica os campos salvos das publicações, e pages sync avisa sobre atributos que um bloco armazena, mas nunca renderiza.
Inspecione pelo terminal
Liste configurações, campos personalizados e recursos com wp bs, e compile um trecho ou arquivo com wp bs tailwind compile ou wp bs scss compile.
O kit oficial de extensões
Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.
- 500+ modelos de sites
- Instruções de sistema para IA
- Atualizações vitalícias
- Comunidade privada de Discord