Search by

masilia / ibexa-ai-craft

masilia

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

Statistics

Installs: 15

Dependents: 0

Suggesters: 3

Stars: 0

Open Issues: 0

2.3.0 2026-11-20 01:19 UTC

This package is auto-updated.

Last update: 2026-11-20 01:19:55 UTC


README

CI Latest version Downloads PHP License: MIT

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.* and site.* 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) over masilia/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:

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-sites requires ibexa-admin-kit
  • ibexa-ai requires ibexa-admin-kit
  • ibexa-ai-editor requires ibexa-ai
  • ibexa-ai-craft requires ibexa-ai, ibexa-blocks and ibexa-sites
  • ibexa-blocks and editorial-toolbox require none of the others; they are happy to find ibexa-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

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.