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: 2

Dependents: 0

Suggesters: 3

Stars: 0

Open Issues: 0

2.2.0 2026-11-17 23:21 UTC

This package is auto-updated.

Last update: 2026-11-18 00:24:22 UTC


README

CI Latest version 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.

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
        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

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

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.