Tailwind v4 sem Node
Cada página compila apenas as classes que usa, em PHP.
Uma configuração, sem etapa de compilação
Defina tailwind.enabled em blockstudio.json e escreva classes utilitárias em qualquer modelo. A cada solicitação do frontend, Blockstudio coleta os candidatos a classe no HTML finalizado e compila exatamente esses com TailwindPHP, uma implementação em PHP da versão 4.3 de Tailwind CSS.
Não há Node.js, CLI nem observador. Classes de modelos de blocos, modelos do tema, plugins e the_content também são consideradas, pois a página inteira é analisada.
{
"tailwind": {
"enabled": true
}
}<section class="bg-slate-950 px-6 py-24">
<h1 class="text-5xl font-semibold tracking-tight text-white">
<?php echo esc_html( $a['title'] ); ?>
</h1>
</section>Sem ambiente de execução Node
TailwindPHP compila durante a solicitação; não há nada para compilar ou implantar.
Utilitários de Tailwind 4.3
Utilitários, variantes, valores arbitrários e diretivas de Tailwind CSS 4.3.
Análise da página inteira
As classes são consideradas onde quer que apareçam no HTML final.
Armazenado em cache por conjunto de classes
Páginas que usam as mesmas classes compartilham um arquivo compilado.
Configuração com CSS em primeiro lugar
Tokens @theme e regras @utility em blockstudio.json ou em um filtro.
Pré-visualização ao vivo no editor
Uma versão integrada para navegador pré-visualiza as classes enquanto você digita.
Saída vinculada
Uma folha de estilos com hash de conteúdo que os navegadores e caches de borda podem manter.
Tipografia e formulários
Os dois plugins oficiais foram portados para PHP e são carregados com @plugin.
Configurado em CSS
Tailwind v4 é configurado com CSS, não com um arquivo JavaScript. Adicione tokens @theme, regras @utility e camadas em tailwind.config ou acrescente-os pelo filtro blockstudio/tailwind/css quando estiverem distribuídos por várias linhas.
Os plugins oficiais de tipografia e formulários foram portados para PHP e carregados com @plugin. Plugins que só existem como pacotes JavaScript não são executados, pois nada executa Node.
Os aliases de classe são regras @apply dentro de @layer utilities, como um .btn criado com utilitários de preenchimento e raio. Eles são compilados tanto no frontend quanto na pré-visualização do editor.
add_filter('blockstudio/tailwind/css', function (string $css): string {
return $css . '
@plugin "@tailwindcss/typography";
@theme { --color-brand: #4f46e5; }
@utility container-narrow {
max-width: 48rem;
margin-inline: auto;
}
';
});{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; } @layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } }"
}
}Classes como campo
Defina um campo classes como "tailwind": true e os editores terão preenchimento automático com a lista completa de classes, além de uma pré-visualização integrada no navegador de Tailwind para cada alteração na tela de edição.
Com assets.reset.enabled, a tela de edição também restaura utilitários de exibição e posicionamento, como flex, grid e sticky, que de outra forma seriam substituídos pelas regras do contêiner do editor.
{
"name": "acme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}<div class="<?php echo esc_attr( $a['classes'] ); ?>">
<InnerBlocks />
</div>Uma folha de estilos, armazenada em cache por conjunto de classes
O CSS compilado é armazenado em cache no disco com uma chave criada a partir dos candidatos a classe da página, ordenados, e da entrada CSS; assim, nonces e marcas de tempo nunca invalidam o cache, e páginas com as mesmas classes compartilham um arquivo.
A saída em linha é o padrão. "output": "link" emite esse arquivo de cache como uma folha de estilos com hash de conteúdo. Em uma medição feita em uma cópia local deste site em 8 de outubro, 2026, o tamanho da página inicial passou de 451,648 para 296,379 bytes com HTML.
Quando cache.path aponta para um volume privado, Blockstudio usa CSS inline como alternativa, a menos que o filtro blockstudio/files/url retorne um URL público para o escopo tailwind, como um host CDN.
{
"tailwind": {
"enabled": true,
"output": "link"
}
}add_filter(
'blockstudio/files/url',
function (string $url, string $path, string $scope): string {
if ('tailwind' !== $scope) {
return $url;
}
return 'https://static.example.com/blockstudio/' . basename($path);
},
10,
3
);Combine classes em PHP
bs_tw_merge() resolve conflitos entre utilitários para que uma classe criada pelo autor prevaleça sobre um padrão. bs_tw_variants() retorna uma função de variante com classes base, variantes, padrões e variantes compostas.
Ambos usam o mecanismo TailwindPHP que Blockstudio já inclui, então um tema não precisa de sua própria cópia.
echo bs_tw_merge('px-2 text-sm', 'px-4');
// text-sm px-4
$button = bs_tw_variants([
'base' => 'inline-flex items-center',
'variants' => [
'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
],
'defaultVariants' => ['size' => 'sm'],
]);
echo $button(['size' => 'lg', 'class' => 'rounded']);Limpeza sob demanda
Runtime_Cache::purge(‘tailwind’) limpa o CSS compilado, e a próxima solicitação o compila novamente.
Buffer de página opcional
Um site que não usa Tailwind nem recursos de blocos pode desativar o buffer de página com o filtro blockstudio/buffer/enabled.
Isolado por origem
Com uma origem lógica de descoberta, a origem selecionada e o contexto de execução passam a fazer parte do namespace do cache, evitando que o último CSS válido vaze entre pré-visualizações.
Ordem canônica das camadas
Tema, base, componentes e, por fim, utilitários, como em Tailwind CSS, para que as camadas posteriores sobrescrevam as anteriores.
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