Desiderio ist ein Theme- und Komponentenpaket für TYPO3 v14.3. Es übersetzt die Denkweise von shadcn/ui in native Fluid-5-Templates, Content Blocks und TYPO3-Site-Settings. Das Ergebnis ist kein separates Frontend-Framework, sondern ein TYPO3-nativer Baukasten: 255 redaktionelle Content Blocks, typisierte Komponenten, page templates, optionale Integrationen und ein runtime-fähiges Theme-System.
Die aktuelle Version ist auf reale TYPO3-Projekte ausgerichtet: Redaktionen bekommen fertige Inhaltsmuster, Entwicklungsteams behalten die Kontrolle über Templates, Tokens, Accessibility, Search, Blog, News und Form-Integrationen.
Inhaltsverzeichnis
Überblick
Was Desiderio heute liefert und welche TYPO3-Version es voraussetzt.
Architektur
Komponenten, Content Blocks und Theme als getrennte Ebenen.
Integrationen
Blog, News, Solr, Forms, Friendly Captcha und Brevo.
Installation
Composer, Site Sets und typische Konfiguration.
Überblick
Desiderio ist ein TYPO3-v14.3-Theme für Composer-basierte Installationen. Die Basis besteht aus Content Blocks, Fluid 5, committed CSS/JavaScript-Assets und TYPO3-Site-Settings. Der Zielzustand ist pragmatisch: Auf dem Zielsystem soll kein eigener Frontend-Build nötig sein, trotzdem bleiben shadcn-Tokens, Dark Mode, Icon Library, Layout-Dichte und Containerbreiten konfigurierbar.
Desiderio setzt TYPO3 CMS ^14.3, PHP ^8.3 und friendsoftypo3/content-blocks ^2.2 voraus. Optionale Integrationen greifen nur, wenn die passenden Extensions installiert sind. TYPO3 v14 LTS wurde am 21. April 2026 veröffentlicht.
Die Extension liefert 255 Content Blocks für typische Marketing-, Editorial-, Daten-, Conversion-, Media-, Social-Proof-, Form-, Navigations- und Footer-Szenarien. Dazu kommen Page Templates für Startseite, Inhaltsseite, Sidebar-Seite, Styleguide, Blog, News, Extension-Seiten und einen Default-Fallback.
Architektur
Desiderio trennt Komponenten, redaktionelle Content Blocks und Theme-Konfiguration.
Die unterste Ebene besteht aus typisierten Fluid-5-Komponenten. Aktuell sind das 17 Atome, 28 Moleküle und 4 Layout-Primitives, zusammen 49 Komponenten. Die Content Blocks bauen darauf auf und verwenden TYPO3 Content Blocks als editorfreundliche Struktur. Die Theme-Ebene steuert Page Templates, Backend Layouts, Header/Footer, CSS-Variablen und JavaScript-Interaktionen.
Optisch bleibt Desiderio nah am shadcn/ui-Modell: Komponenten benutzen semantische Varianten, Tokens und Primitives statt projektspezifischer Sonderklassen. Der aktuelle shadcn-Default ist radix-lyra mit dem b6G5977cw mono-olive Preset und Tabler-Icons. Der Laufzeit-Preset-Selector bringt zusätzlich vier weitere ui.shadcn.com/create-Presets, zehn gebündelte Haus-Presets und custom mit.
| Bereich | Aktueller Stand |
|---|---|
| Komponenten | 17 Atome, 28 Moleküle, 4 Layout-Primitives (49 typisierte Fluid-Komponenten). |
| Content Blocks | 255 redaktionelle Elemente für Hero, Features, Data, Conversion, Editorial, Media, Social Proof, Navigation, Forms und Footer. |
| Theming | Preset, Style, Icon Library, Density, Container, Radius, Schrift und Dark Mode über Site Settings. |
| Frontend-Assets | Committed Tailwind-v4/shadcn-CSS, Alpine, Astro-style Interactions, Chart Helpers und prism-lite Syntax Highlighting. |
| Page Templates | Startpage, Contentpage, Sidebar, Styleguide, Blog, News, Extension und Default. |
Integrationen
Desiderio ist bewusst modular. Das Basis-Set bleibt lauffähig ohne Blog-, News-, Solr- oder Powermail-Extension. Die jeweiligen Template-Overrides und Konfigurationen werden über eigene Site Sets aktiviert.
Blog
Wenn t3g/blog installiert ist, fügt webconsulting/desiderio-blog shadcn-styled Blog-Templates hinzu. Abgedeckt sind List- und Detailansicht, Sidebar-Widgets, Kommentare, Autor-Blöcke, Related Posts, Kategorie- und Schlagwort-Badges, Metadaten und RSS-Ausgaben mit passenden HTTP-Headern.
vendor/bin/typo3 desiderio:blog:seed-pages --root=<blog-root-uid>News
Wenn georgringer/news installiert ist, stellt webconsulting/desiderio-news List- und Detailtemplates für News bereit. Die Templates verwenden vorhandene News-Bilder, Kategorie- und Schlagwort-Badges, responsive Grids, Metadaten, ein DesiderioNews Backend Layout und NewsArticle Structured Data.
Suche mit Solr
Das DesiderioSolr Set bringt shadcn-styled Search-Templates, Result Cards, Facets und einen Suggest-Endpunkt mit. Die Header-Suche kann über Site Settings aktiviert und auf eine bestehende Suchergebnisseite verlinkt werden.
desiderio.search.enabled: true
desiderio.search.targetPageId: 123
desiderio.search.queryParameter: qFormulare, Friendly Captcha und Brevo
TYPO3 Form Framework und Powermail nutzen einen gemeinsamen shadcn-nahen FormRenderer. Eingabefelder verwenden neutrale Theme-Borders; nur ungültige Felder wechseln auf destructive/red. Friendly Captcha kann lokal im Development-Kontext mit Testmodus laufen. Brevo wird über einen eigenen Finisher angebunden und nutzt BREVO_API_KEY plus Site Settings für Listen und Events.
Installation
composer require webconsulting/desiderio
vendor/bin/typo3 extension:setup
vendor/bin/typo3 cache:flushHäufige Fragen
Fazit
Desiderio ist inzwischen mehr als ein Theme-Prototyp. Es ist ein TYPO3-v14-Baukasten mit typisierten Fluid-Komponenten, 255 Content Blocks, runtime-fähigem shadcn-Theming und optionalen Integrationen für redaktionelle und conversion-orientierte Projekte. Die wichtigste Entscheidung bleibt die Architektur: Komponenten, Content Blocks und Theme sind getrennt genug, um wartbar zu bleiben, aber eng genug, um Redaktionen sofort produktiv arbeiten zu lassen.
Desiderio orientiert sich an shadcn/ui und baut auf TYPO3 Content Blocks, Fluid 5 und TYPO3 v14 auf. Das Theme steht unter der GPL-2.0-or-later.