Search by

masilia / ibexa-admin-kit

masilia

React components in the design of the Ibexa admin (fields, dropdown, tabs, table, dialogs, content browser picker…) for the admin pages of the Masilia packages

Package info

github.com/MasiliaLabs/ibexa-admin-kit

Language:TypeScript

Type:ibexa-bundle

pkg:composer/masilia/ibexa-admin-kit

Statistics

Installs: 21

Dependents: 2

Suggesters: 0

Stars: 0

Open Issues: 0

0.1.1 2026-11-17 23:21 UTC

This package is auto-updated.

Last update: 2026-11-18 00:15:55 UTC


README

CI Latest version PHP License: MIT

React components in the design of the Ibexa admin, for the admin pages of your bundles.

masilia/ibexa-admin-kit is part of a family of packages for Ibexa that work together or alone. See the other packages.

What it is

The admin pages of the Masilia packages are React applications. This package holds the parts they share, written once, with the look, the classes and the behaviour of the Ibexa admin: fields, dropdowns, tabs, tables, dialogs, filter bars, notices, a content browser picker… You can use them in the admin pages of your own bundles too.

It reuses what Ibexa already has instead of copying it: the global CSS classes of the admin (ibexa-btn, ibexa-table, ibexa-tabs…), the components of the Ibexa Design System (@ids-components) and Ibexa's own helpers (notifications, the Universal Discovery Widget, the icon sprite). Nothing of Ibexa is bundled here, so your pages follow the admin when it changes.

What is in it

Area Components and helpers
Fields TextField (text, number, password, url), DropdownField and MultiDropdownField (search included), Checkbox, CheckboxGroup, OrderedChoice (an ordered list: up, down, remove, add)
Layout Tabs (the tabs of the admin, with keyboard navigation), Section (an accordion section), TableHeader and DataTable (zebra rows, sticky actions column, empty state), FilterCard with FilterSelect and SearchInput (the adaptive filters bar)
Feedback Notice (the informative text of a table header), StatusTag, StatTile, Spinner, notify() (Ibexa's toast)
Actions IconButton (with a busy state), ExternalLink, Dialog and ConfirmDialog (focus trap, Escape, side panel or centred)
Content UdwPicker: choose a location with the Universal Discovery Widget and show its name and path
Helpers http (JSON calls with the admin's CSRF token, errors as values, problems by field), i18n (the Bazinga JS translator with English fallbacks), udw, adapters, useDebounced

Requirements

  • PHP 8.3 or later
  • Ibexa 5.0 (Symfony 7.4)
  • Node.js 24 and Yarn, to build the admin assets with the Ibexa Encore setup of your project

Installation

composer require masilia/ibexa-admin-kit
  1. Enable the bundle in config/bundles.php:

    Masilia\Bundle\IbexaAdminKit\MasiliaIbexaAdminKitBundle::class => ['all' => true],

    The bundle has no PHP to wire. Its job is to ship Resources/encore/ibexa.config.setup.js, which Ibexa's Encore setup reads from every enabled bundle to add the alias @masilia-admin-kit.

  2. Regenerate the Encore configuration and the TypeScript paths, then build the admin assets (Composer's auto-scripts of an Ibexa project do the first two):

    php bin/console cache:clear
    yarn ibexa-generate-tsconfig
    yarn encore dev   # or: yarn encore production

Usage

Declare the entries of your admin page in the ibexa Encore configuration of your bundle (Resources/encore/ibexa.config.js), as any Ibexa bundle does, then import the components through the alias:

import React from 'react';
import { DropdownField } from '@masilia-admin-kit/Dropdown';
import { DataTable, TableHeader } from '@masilia-admin-kit/Table';
import { notify } from '@masilia-admin-kit/notify';

export function Example({ rows }: { rows: Row[] }): React.ReactElement {
    return (
        <>
            <TableHeader headline="Rows" count={rows.length} />
            <DataTable
                label="Rows"
                rows={rows}
                rowKey={(row) => row.id}
                columns={[{ key: 'name', header: 'Name', render: (row) => row.name }]}
                empty={{ info: 'Nothing here yet' }}
            />
        </>
    );
}

Styles: @use '@masilia-admin-kit/kit'; in the SCSS of your page.

Things to know:

  • There is one React on an admin page: window.React, provided by the ibexa Encore build. Mount with window.ReactDOMClient.createRoot, never with react-dom/client. The JSX runtime is the classic one (import React from 'react').
  • Components must be built by the ibexa Encore configuration (the admin's), not by the front-office one.
  • Texts come from your own translation domain: publish it with bazinga_js_translation.active_domains and give createTranslator your English defaults.

Tests

The logic that does not need a browser is tested with Node's built-in runner, with nothing to install:

cd src/bundle/Resources/public/admin
node --experimental-strip-types --import ./test-hooks/register.mjs --test *.test.ts

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-admin-kit — ibexa-admin-kit on Packagist
  • Archive of a release: GitHub releases (each release lists what changed)
  • Source: git clone https://github.com/MasiliaLabs/ibexa-admin-kit.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.