balatd / kern-ux

1.0.0-beta.3 2026-11-06 12:42 UTC

Requires

• php: ^8.2
• friendsoftypo3/content-blocks: ^1.6 || ^2.4
• typo3/cms-core: ^13.4 || ^14.3

Requires (Dev)

• phpstan/phpstan: ^2.1
• typo3/cms-felogin: ^13.4 || ^14.3
• typo3/cms-fluid-styled-content: ^13.4 || ^14.3
• typo3/cms-form: ^13.4 || ^14.3
• typo3/cms-rte-ckeditor: ^13.4 || ^14.3
• typo3/coding-standards: ^0.9
• typo3/testing-framework: ^9.6
• webmozart/assert: ^1.11 || ^2

Suggests

• ext-gd: Required by kern-ux:demo:install, which draws the demo images rather than shipping licensed binaries.
• typo3/cms-felogin: Required for the KERN-compliant login, logout and password-recovery templates.
• typo3/cms-form: Required for the KERN-compliant ext:form templates and the KernDate form element.
• typo3/cms-rte-ckeditor: Required for the KERN rich-text preset; without it RTE fields fall back to a plain textarea.

GPL-2.0-or-later

• Dragan Balatinac

• typo3
• accessibility
• wcag
• design-system
• content-blocks
• bitv
• kern-ux
• oeffentliche-verwaltung

Published on Packagist.org on 2026-11-06 12:43 UTC

README

KERN UX-Standard für TYPO3

Bringt den KERN UX-Standard nach TYPO3 13.4 und 14.3: 42 barrierefreie Fluid Components, 24 Content Blocks für Redakteure, ein ext:form-Theme samt Formularvorlagen und fünf Seiten-Templates mit passenden Backend-Layouts.

Die Components sind die einzige Quelle für KERN-Markup — Content Blocks, Formulare und Seiten rufen dieselben Components auf und bilden nur Daten darauf ab. Weil die Barrierefreiheits-Zusagen von KERN an konkreten Klassen und ARIA-Attributen hängen, existiert dieses Markup genau einmal und wird von Tests festgenagelt, die unter beiden TYPO3-Majors laufen.

Important

Status: beta. Die öffentliche Schnittstelle gilt als eingefroren: was unter Breaking changes in CLAUDE.md steht, ändert sich nicht mehr ohne Eintrag im Changelog, und Tests halten es fest. Für einen Produktiveinsatz lohnt ein eigener Blick — die Extension ist in dieser Form noch nicht lange im Feld.

Note

Unabhängige Community-Integration. Dieses Projekt gehört nicht zum KERN-Team und ist kein offizielles KERN-Kit. „KERN" und die Digitale Dachmarke für Deutschland sind Kennzeichen ihrer jeweiligen Inhaber; dieses Projekt beansprucht keine Rechte daran und wird von ihnen nicht unterstützt oder geprüft.

📸 Screenshots ansehen — Seiten, Formularstrecke, Mobilmenü, dunkles Thema, Component-Galerie und die Redakteurs-Sicht im Backend, alles aus dem mitgelieferten Demo-Seitenbaum.

Voraussetzungen

TYPO3	13.4 LTS oder 14.3 LTS
PHP	8.2 – 8.5
Content Blocks	friendsoftypo3/content-blocks (1.x unter v13, 2.x unter v14)
ext:form	optional, nur für die Formular-Templates

Installation

Das Paket liegt auf Packagist. Veröffentlicht ist bisher nur eine Vorabversion, deshalb braucht Composer die Stabilitätsangabe @beta — ein Projekt mit dem üblichen minimum-stability: stable findet das Paket sonst nicht:

composer require balatd/kern-ux:^1.0@beta
vendor/bin/typo3 extension:setup
vendor/bin/typo3 kern-ux:assets:install

Der letzte Schritt ist erforderlich: die KERN-Distribution wird bewusst nicht mitgeliefert, sondern einmalig zur Installationszeit von npm geholt und per SHA-512 geprüft (siehe THIRD-PARTY.md). Zur Laufzeit werden keine Fremd-Requests ausgeführt und kein CDN eingebunden. Das Zielverzeichnis ist nicht eingecheckt, der Schritt gehört also in jedes Deployment — am sichersten als Composer-Skript, siehe Im Deployment.

Danach in der Site das Set KERN UX-Standard auswählen — damit stehen Templates, Backend-Layouts und Settings bereit. Einen Demo-Seitenbaum zum Ansehen legt kern-ux:demo:install an; beides samt einer Falle im TYPO3-Setup beschreibt die Installationsanleitung.

Dokumentation

Installation	Setup, KERN-Assets, Demo-Seitenbaum, Stolperfallen
Konfiguration	Site-Settings, Thema, Navigation, Digitale Dachmarke, RTE
Components	Component-Schicht, Galerie, eigene Components schreiben
Content Blocks	Die 24 Blöcke, Seiten-Templates, Backend-Vorschauen
Formulare	ext:form-Theme, Fehlerbehandlung, KernDate
Barrierefreiheit	axe-Läufe, Prüfumfang, was von Hand bleibt
Entwicklung	DDEV-Harness für beide Majors, Tests, Sprachen
Screenshots	Der Demo-Seitenbaum in Bildern

Lizenz

GPL-2.0-or-later. Zu den Lizenzen der zur Installationszeit geholten KERN-Assets siehe THIRD-PARTY.md.