masilia / ibexa-admin-kit
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
Requires
- php: >=8.3
- ibexa/admin-ui: ^5.0
- symfony/http-kernel: ^7.4
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 00:15:55 UTC
README
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
-
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. -
Regenerate the Encore configuration and the TypeScript paths, then build the admin assets (Composer's
auto-scriptsof 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 theibexaEncore build. Mount withwindow.ReactDOMClient.createRoot, never withreact-dom/client. The JSX runtime is the classic one (import React from 'react'). - Components must be built by the
ibexaEncore configuration (the admin's), not by the front-office one. - Texts come from your own translation domain: publish it with
bazinga_js_translation.active_domainsand givecreateTranslatoryour 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-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-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
- Questions and bug reports: GitHub issues
- 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.