masilia / ibexa-ai-craft
How Masilia sites are built, for the Ibexa AI OS: pages made of blocks, site structures, and the conventions that go with them
Package info
github.com/MasiliaLabs/ibexa-ai-craft
Type:ibexa-bundle
pkg:composer/masilia/ibexa-ai-craft
Requires
- php: >=8.3
- ibexa/core: ^5.0
- masilia/ibexa-ai: ^2.0
- masilia/ibexa-blocks: ^0.3 || ^0.4 || ^0.5 || ^0.6
- masilia/ibexa-sites: ^0.1 || ^0.2
- psr/cache: ^3.0
- psr/log: ^3.0
- symfony/config: ^7.4
- symfony/console: ^7.4
- symfony/dependency-injection: ^7.4
- symfony/http-kernel: ^7.4
Requires (Dev)
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^11.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Lets the Ibexa AI assistant build sites and pages out of blocks: page composition, site structures, themes and lists.
masilia/ibexa-ai-craft is part of a family of packages for Ibexa that work together or alone. See the other packages.
What it is
A layer on masilia/ibexa-ai that teaches the assistant how a site is built out of blocks: a page holds blocks, a block may hold items, a theme gives them templates. It reads the conventions of your project instead of assuming them, and every change goes through the assistant's approval flow.
Features
- Pages and sites:
page.*andsite.*capabilities to explore a site, mine its conventions from its own pages, create a site structure (container, home page, layout configuration) in one transaction, and add blocks and their child items to a page. - Site registry:
site.config.*capabilities (list, describe, create, update, set status, delete, default siteaccess) overmasilia/ibexa-sites. - Themes:
theme.*capabilities to check the design of a site (every block type shown has a template) and, when you allow it, to create a theme that extends another. Writing files is off by default. - Lists, item kinds and newsletter subscribers as capabilities, on the contracts of
masilia/ibexa-blocks. - Self-test scenario for the page-of-blocks flow, added to
masilia:ai:os:selftest.
Requirements
- PHP 8.3 or later
- Ibexa 5.0 (Symfony 7.4)
Installed with it by Composer:
masilia/ibexa-aithe assistant itselfmasilia/ibexa-blocksthe content model of pages made of blocksmasilia/ibexa-sitesthe registry of sites
Installation
composer require masilia/ibexa-ai-craft
Composer installs masilia/ibexa-ai, masilia/ibexa-blocks and masilia/ibexa-sites with it. Enable what is new in config/bundles.php:
Masilia\Bundle\IbexaAdminKit\MasiliaIbexaAdminKitBundle::class => ['all' => true], Masilia\Bundle\IbexaAi\MasiliaIbexaAiBundle::class => ['all' => true], Masilia\Bundle\IbexaBlocks\MasiliaIbexaBlocksBundle::class => ['all' => true], Masilia\Bundle\IbexaSites\MasiliaIbexaSitesBundle::class => ['all' => true], Masilia\Bundle\IbexaAiCraft\MasiliaIbexaAiCraftBundle::class => ['all' => true],
See the README of each of them for their own routes, migrations and assets.
With Symfony Flex
The Masilia recipes do the first steps for you. Add their endpoint once to the composer.json of your project, after the one of Ibexa:
"extra": { "symfony": { "endpoint": [ "https://api.github.com/repos/ibexa/recipes/contents/index.json?ref=flex/main", "https://api.github.com/repos/MasiliaLabs/recipes/contents/index.json?ref=flex/main", "flex://defaults" ] } }
Then composer require masilia/ibexa-ai-craft enables the bundle. What is left is yours: the content model (masilia:blocks:model:install) and a provider in the admin. The manual steps above and below stay valid.
Configuration
The conventions are shared with masilia_ibexa_blocks when it is configured; set them here only for what differs.
masilia_ibexa_ai_craft: conventions: page_type: page # the content type of a page blocks_field: blocks # the field of a page that holds its blocks items_field: items # the field of a block that holds its child items items_field_by_type: # block types that call it differently info_cards: cards block_group: Blocks # the content type group of the blocks blocks_folder_suffix: Blocks # the blocks of a page go in a folder under it: "<page name> Blocks" (shared with masilia_ibexa_blocks) site_type: site home_page_type: home_page layout_type: layout_config folder_type: folder theme_creation: false # true lets theme.create write the files of a new theme
Where blocks are made: the blocks of a page or of the home page go in a folder under that page, named after it (About Blocks) and found by the remote id of the page and _blocks; the folder is made when it is missing, and the page must be a container (home_page is one from masilia/ibexa-blocks 0.6, masilia:blocks:model:install --allow-container for a project that has it already). site.create_structure makes the folder of the home and of each page it creates. Blocks that exist elsewhere are not moved, and the child items of a block keep their own folder.
Usage
Ask the assistant in the chat. For instance: "Which blocks can I put on the home page of the shop site?", "Add a hero and three cards to the About page", "Create a site called Acme Shop on acme.example.org". Each change is shown in an approval card first.
Tests
composer install vendor/bin/phpunit vendor/bin/phpstan analyse --memory-limit=2G --no-progress
AI agent skill
This package ships a skill for AI coding agents (Claude Code and other agents that read SKILL.md skills): how to install, configure, operate and troubleshoot masilia/ibexa-ai-craft. It lives in skills/masilia-ibexa-ai-craft and comes with the package.
# For the project (committed with it): from the installed package mkdir -p .claude/skills && cp -r vendor/masilia/ibexa-ai-craft/skills/masilia-ibexa-ai-craft .claude/skills/ # For all your projects: global mkdir -p ~/.claude/skills && cp -r vendor/masilia/ibexa-ai-craft/skills/masilia-ibexa-ai-craft ~/.claude/skills/
Restart the agent (or reload its skills) to pick it up. Update the copy after composer update.
The Masilia packages
| Package | What it does |
|---|---|
masilia/ibexa-admin-kit |
React components in the design of the Ibexa admin, for admin pages |
masilia/ibexa-sites |
A registry of sites that Ibexa serves without a deploy |
masilia/ibexa-ai |
The AI assistant for Ibexa: capabilities, providers, chat, approval flow |
masilia/ibexa-ai-craft |
The assistant builds sites and pages out of blocks |
masilia/ibexa-ai-editor |
AI suggestions and image generation in the content editing form |
masilia/ibexa-blocks |
Front-office rendering of pages made of blocks, with themes |
masilia/editorial-toolbox |
In-context editing toolbar for the front office |
What requires what (Composer installs it for you):
ibexa-sitesrequiresibexa-admin-kitibexa-airequiresibexa-admin-kitibexa-ai-editorrequiresibexa-aiibexa-ai-craftrequiresibexa-ai,ibexa-blocksandibexa-sitesibexa-blocksandeditorial-toolboxrequire none of the others; they are happy to findibexa-sites(and each other) when installed.
Compatibility
| Package version | PHP | Ibexa |
|---|---|---|
latest |
8.3+ | 5.0 |
Download
- Composer (recommended):
composer require masilia/ibexa-ai-craft— ibexa-ai-craft on Packagist - Archive of a release: GitHub releases (each release lists what changed)
- Source:
git clone https://github.com/MasiliaLabs/ibexa-ai-craft.git - What changed between versions: CHANGELOG.md
Support, contributing and security
- Questions and bug reports: GitHub issues
- Upgrading across a breaking change: UPGRADE.md
- Pull requests are welcome, see CONTRIBUTING.md
- Security problems: please follow SECURITY.md and do not open a public issue
License
Released under the MIT license. Copyright © 2026 MasiliaLabs.
Ibexa itself is distributed under its own licenses (Ibexa OSS: GPL-2.0), which apply to the project that uses this package. This package is an independent project, not affiliated with or endorsed by Ibexa AS; "Ibexa" is a trademark of its owner.