Desiderio is a theme and component package for TYPO3 v14.3. It brings the philosophy of shadcn/ui to native Fluid 5 templates, Content Blocks, and TYPO3 Site Settings. The result is not a separate frontend framework but a TYPO3-native kit: 255 editorial Content Blocks, typed components, page templates, optional integrations, and a runtime-configurable theme system.
The current version is built for real-world TYPO3 projects: editors get ready-to-use content patterns, while development teams keep full control over templates, tokens, accessibility, search, blog, news, and form integrations.
Table of Contents
Overview
What Desiderio delivers today and which TYPO3 version it requires.
Architecture
Components, Content Blocks, and the theme as separate layers.
Integrations
Blog, News, Solr, forms, Friendly Captcha, and Brevo.
Installation
Composer, Site Sets, and typical configuration.
Overview
Desiderio is a TYPO3 v14.3 theme for Composer-based installations. Its foundation is built on Content Blocks, Fluid 5, committed CSS/JavaScript assets, and TYPO3 Site Settings. The approach is deliberately pragmatic: the target system needs no custom frontend build, yet shadcn tokens, dark mode, icon library, layout density, and container widths all remain fully configurable.
Desiderio requires TYPO3 CMS ^14.3, PHP ^8.3, and friendsoftypo3/content-blocks ^2.2. Optional integrations only kick in if the corresponding extensions are installed. TYPO3 v14 LTS was released on 21 April 2026.
The extension ships 255 Content Blocks for typical marketing, editorial, data, conversion, media, social proof, form, navigation, and footer scenarios. On top of these come page templates for the homepage, content page, sidebar page, style guide, blog, news, extension pages, and a default fallback.
Architecture
Desiderio separates components, editorial Content Blocks, and theme configuration.
The lowest layer is made up of typed Fluid 5 components: currently 17 atoms, 28 molecules, and 4 layout primitives, for 49 components in total. The Content Blocks build on these and use TYPO3 Content Blocks to provide an editor-friendly structure. The theme layer then controls page templates, backend layouts, headers and footers, CSS variables, and JavaScript interactions.
Visually, Desiderio stays close to the shadcn/ui model: components rely on semantic variants, tokens, and primitives rather than project-specific custom classes. The current shadcn default is radix-lyra with the b6G5977cw mono-olive preset and Tabler Icons. Beyond that, the runtime preset selector offers four further ui.shadcn.com/create presets, ten bundled in-house presets, and a custom option.
| Area | Current Status |
|---|---|
| Components | 17 atoms, 28 molecules, 4 layout primitives (49 typed Fluid components). |
| Content Blocks | 255 editorial elements for hero, features, data, conversion, editorial, media, social proof, navigation, forms, and footers. |
| Theming | Preset, style, icon library, density, container, radius, font, and dark mode via Site Settings. |
| Frontend Assets | Committed Tailwind v4/shadcn CSS, Alpine, Astro-style interactions, chart helpers, and prism-lite syntax highlighting. |
| Page Templates | Homepage, content page, sidebar, style guide, blog, news, extension, and default. |
Integrations
Desiderio is deliberately modular. The base set works perfectly well without the blog, news, Solr, or Powermail extensions, and the relevant template overrides and configuration only switch on through their own Site Sets.
Blog
If t3g/blog is installed, webconsulting/desiderio-blog adds shadcn-styled blog templates. These cover list and detail views, sidebar widgets, comments, author blocks, related posts, category and tag badges, metadata, and RSS feeds with the matching HTTP headers.
vendor/bin/typo3 desiderio:blog:seed-pages --root=<blog-root-uid>News
If georgringer/news is installed, webconsulting/desiderio-news provides list and detail templates for news. They make use of existing news images, category and tag badges, responsive grids, metadata, a DesiderioNews backend layout, and NewsArticle structured data.
Search with Solr
The DesiderioSolr set includes shadcn-styled search templates, result cards, facets, and a suggest endpoint. The header search can be enabled via Site Settings and linked to an existing search results page.
desiderio.search.enabled: true
desiderio.search.targetPageId: 123
desiderio.search.queryParameter: qForms, Friendly Captcha, and Brevo
The TYPO3 Form Framework and Powermail share a single shadcn-like FormRenderer. Input fields use neutral theme borders, and only invalid fields switch to destructive red. Friendly Captcha can run locally in a development context using test mode. Brevo is connected through a dedicated finisher and uses BREVO_API_KEY together with Site Settings for lists and events.
Installation
composer require webconsulting/desiderio
vendor/bin/typo3 extension:setup
vendor/bin/typo3 cache:flushFrequently Asked Questions
Conclusion
Desiderio has grown into far more than a theme prototype. It is a TYPO3 v14 component kit with typed Fluid components, 255 Content Blocks, runtime shadcn theming, and optional integrations for editorial and conversion-focused projects. The defining decision remains the architecture: components, Content Blocks, and the theme are separated cleanly enough to stay maintainable, yet integrated closely enough that editors can be productive from day one.
Desiderio is inspired by shadcn/ui and is built on TYPO3 Content Blocks, Fluid 5, and TYPO3 v14. The theme is licensed under the GPL-2.0-or-later.