PHPackages                             blockstudio/blockstudio - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. blockstudio/blockstudio

ActiveWordpress-plugin[Framework](/categories/framework)

blockstudio/blockstudio
=======================

The block framework for WordPress.

v7.6.2(1w ago)563.4k5[4 issues](https://github.com/inline0/blockstudio/issues)[1 PRs](https://github.com/inline0/blockstudio/pulls)GPL-2.0-or-laterPHPPHP &gt;=8.2CI passing

Since Feb 24Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/inline0/blockstudio)[ Packagist](https://packagist.org/packages/blockstudio/blockstudio)[ RSS](/packages/blockstudio-blockstudio/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (52)Versions (55)Used By (0)

 [    ![Blockstudio](./.github/logo-light.svg)  ](https://blockstudio.dev)

 The block framework for WordPress

 [![Documentation](https://camo.githubusercontent.com/fda2c57398b43d6d0226693eea50de0f0974f4a56f800d457cd1fc6376816fdb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d626c6f636b73747564696f2e6465762d626c7565)](https://blockstudio.dev/docs) [![License](https://camo.githubusercontent.com/1cdd36e7766aae67347405e8fd80ab609e2edce611cf987af991adce976d7ddb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d322e302d626c7565)](https://github.com/inline0/blockstudio/blob/main/LICENSE)

---

Drop a `block.json` and a PHP template into a folder. Blockstudio registers the block, renders the template, and handles fields, assets, and scoped styles. No webpack, no Vite, no React components to write.

```
theme/blockstudio/hero/
├── block.json      ← fields, settings, metadata
├── index.php       ← template (PHP, Twig, or Blade)
├── style.scss      ← auto-compiled, scoped, minified
└── script.js       ← ES module imports from npm

```

Why Blockstudio
---------------

[](#why-blockstudio)

WordPress blocks are powerful but building them is painful. The official approach requires React, JSX, a build toolchain, and hundreds of lines of JavaScript for even a simple block.

Blockstudio removes all of that. You write a JSON config and a PHP template. The framework handles block registration, field rendering, asset compilation, and editor integration. Everything lives in the filesystem, which makes blocks easy to version control, share across projects, and generate with AI coding tools.

Features
--------

[](#features)

- **26 field types** - text, repeater, tabs, code, classes, color, files, and more, all configured in JSON with conditions, validation, and defaults
- **PHP, Twig, and Blade** - write templates in your preferred language with the same `$a` variable across all three
- **File-based pages** - create WordPress pages from HTML templates with explicit API or CLI syncing, keyed block merging, and editing controls
- **Site Editor templates** - define WordPress templates and template parts from PHP, Twig, Blade, or HTML while preserving Site Editor customizations
- **File-based patterns** - define block patterns as template files, auto-registered without any PHP code
- **Block islands** - hydrate cache-safe blocks or batch-render dynamic fragments after the initial response
- **HTML-to-block parser** - converts standard HTML into native WordPress block markup with extensible renderers and element mapping
- **Extensions** - add custom fields to any core or third-party block via a JSON file
- **Asset pipeline** - SCSS compilation, ES module imports from npm, automatic minification, and scoped loading by naming convention
- **Tailwind CSS v4** - server-side compilation via TailwindPHP with candidate-based caching, no Node.js or CLI needed
- **Bundled UI library** - 59 headless `bsui/*` components on the Interactivity API, from buttons and selects to dialogs, menus, and forms, composable in any template
- **Database layer** - use REST and PHP/JS clients across MySQL, SQLite, JSONC, post meta, custom post types, or Storh
- **Storage** - persist field values in post meta or site options, queryable via `WP_Query` and the REST API
- **Custom fields** - reusable field definitions shared across multiple blocks via filesystem or PHP filter
- **Custom field types** - register namespaced controls with primitive, array, or object values and typed storage schemas
- **SEO integration** - block content visible to Yoast SEO and Rank Math for editor analysis
- **AI-ready** - ships a pre-built context file with documentation and JSON schemas for LLM coding assistants
- **50+ PHP and JS hooks** - customize every aspect of the framework

Quick start
-----------

[](#quick-start)

1. Install via Composer:

```
composer require blockstudio/blockstudio
```

2. Create a `blockstudio` folder in your theme
3. Add a block:

**block.json**

```
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "theme/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading" },
      { "id": "description", "type": "textarea", "label": "Description" }
    ]
  }
}
```

**index.php**

```

```

The block appears in the editor with the fields you defined. Add a `style.scss` or `script.js` to the same folder and they get compiled and enqueued automatically.

Requirements
------------

[](#requirements)

- PHP 8.2+
- WordPress 6.7+

Documentation
-------------

[](#documentation)

**[blockstudio.dev/docs](https://blockstudio.dev/docs)**

License
-------

[](#license)

[GPL-2.0](LICENSE)

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance93

Actively maintained with recent releases

Popularity37

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

52

Last Release

9d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dc81a975082b6843421de211768cfb67d8237bed4c972c9a1eaad46aac14b372?d=identicon)[dnnsjsk](/maintainers/dnnsjsk)

---

Top Contributors

[![dnnsjsk](https://avatars.githubusercontent.com/u/73965001?v=4)](https://github.com/dnnsjsk "dnnsjsk (833 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/blockstudio-blockstudio/health.svg)

```
[![Health](https://phpackages.com/badges/blockstudio-blockstudio/health.svg)](https://phpackages.com/packages/blockstudio-blockstudio)
```

###  Alternatives

[contao/core-bundle

Contao Open Source CMS

1301.7M3.0k](/packages/contao-core-bundle)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k19](/packages/tempest-framework)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.9M532](/packages/pimcore-pimcore)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[statamic/cms

The Statamic CMS Core Package

4.9k3.8M1.1k](/packages/statamic-cms)[october/rain

October Rain Library

1601.7M99](/packages/october-rain)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
