Skip to content
BranchesTags

Repository files navigation

TYPO3 Extension t3sbootstrap

Latest Stable Version Monthly Downloads Total Downloads License Donate

A startup extension for TYPO3 that brings the full power of Bootstrap 5 — classes, components, layouts and utilities — directly into the TYPO3 backend, out of the box.

Editors get rich, ready-to-use Bootstrap content elements. Integrators get a clean, configurable foundation so they can stop reinventing the wheel for every project.

🌐 Live demos, documentation & tutorials: https://www.t3sbootstrap.de/

Table of Contents

What's new in 5.3.50

EXT:t3sb_package is no longer required. Everything the extension generates now lives below typo3temp/assets/t3sbootstrap/ instead of being written into a site package:

typo3temp/assets/t3sbootstrap/
    TypoScript/       t3sbconstants.typoscript, t3sbsetup.typoscript
    T3SB-SCSS/        custom-variables-<uid>.scss, custom-<uid>.scss
    T3SB-CSS/         downloaded CSS
    T3SB-JS/          downloaded JS
    T3SB-Bootstrap/   Bootstrap sources from the release zip
    css/              compiled CSS

None of it is a source: the TypoScript and the SCSS are derived from the configuration record in the database, the compiled CSS is derived from those, and the downloads are reproducible with t3sbootstrap:cdnToLocal. A middleware rewrites missing TypoScript and SCSS from the database on the next frontend request — after a deployment, after Remove Temporary Assets, or on a fresh install.

Further changes:

  • Upgrade wizard Move generated assets out of EXT:t3sb_package copies existing files to the new location once. Nothing is deleted.
  • Configuration transfer — export and import a site's configuration as JSON directly in the T3SB backend module, with three import modes (update in place / replace / add).
  • RTE — the alert box is now a dropdown offering all eight Bootstrap 5 contextual variants, and a dedicated stylesheet shows the alert colors inside the editor.
  • New setting flexformDir — the directory holding your own FlexForm overrides is now configurable instead of being fixed to EXT:t3sb_package/Configuration/FlexForms/.
  • b13/container moves to ^4.1. If your root composer.json pins an older major, raise it: composer require "b13/container:^4.1" -W
  • Numerous bug fixes across frontend rendering, the migration commands and the TCA.

After updating, flush all caches (several constructor signatures changed, the compiled DI container has to be rebuilt) and run the database schema update.

Highlights

  • Bootstrap 5 out of the box — all components, utilities and grid classes ready to use
  • Rich content elements — extended FSC elements plus Bootstrap-specific ones (cards, carousels, accordions, tabs, modals, …)
  • Backend configuration module — global and per-page settings, no TypoScript required for the basics
  • Container-based layouts — built on EXT:container for clean, structured content
  • Site Sets support — uses the modern TYPO3 v13+ Site Settings approach (recommended over legacy "static templates")
  • Dark mode, breakpoints, utility colors — configurable from the backend module
  • CDN by default, local assets optional — load CSS/JS from CDN or serve them locally from typo3temp/assets/
  • Self-contained — no companion site package required; generated files are restored from the database when missing
  • Extendable via companion extensions — theme builder, swiper slider, iconpack and more (see ecosystem)

Requirements

Component Version
TYPO3 ^14.3
PHP >= 8.2
b13/container ^4.1

Always check the latest requirements in composer.json of the current release — supported TYPO3 versions evolve with each major release.

Installation

Via Composer (recommended)

In your Composer-based TYPO3 project root, run:

composer require t3sbs/t3sbootstrap

Then activate the extension and flush the caches:

vendor/bin/typo3 extension:setup
vendor/bin/typo3 cache:flush

Via TYPO3 Extension Repository (TER)

  1. Install the required dependency first: container.
  2. Download and install t3sbootstrap via the Extension Manager in the TYPO3 backend.
  3. Flush all caches.

Setup after installation

After installation, complete these steps to get a working frontend:

  1. Site Settings (TYPO3 v13+, recommended) Include the "T3S Bootstrap - MAIN SETTINGS" in your site configuration. Also include "Fluid Styled Content" there and remove it from the legacy Static Template include. 👉 More info: https://www.t3sbootstrap.de/dokumentation/installation

  2. Configuration module Open the "T3sb" backend module and configure global defaults (navbar, footer, breakpoints, colors, etc.) for your site.

  3. Assets: CDN vs. local By default, Bootstrap CSS & JS are loaded via CDN. For production, serve them locally: run the Scheduler task "T3SB CDN to local" (vendor/bin/typo3 t3sbootstrap:cdnToLocal), then switch off Enable CDN in the site settings. The files end up in typo3temp/assets/t3sbootstrap/.

  4. Custom SCSS (optional) With Enable CDN switched off you can activate Enable Custom SCSS and run vendor/bin/typo3 t3sbootstrap:customScss with the root page ID. Bootstrap variables and your own SCSS are then editable in the T3SB backend module.

Deployments: the CDN downloads are the only files that cannot be rebuilt from the database. If typo3temp/ is not carried over between releases, run t3sbootstrap:cdnToLocal again after each deployment. The backend module points this out when local delivery is configured and the files are missing.

Configuration

t3sbootstrap offers a wide range of options via Extension Configuration (Settings → Extension Configuration → t3sbootstrap), TypoScript, and the website settings, as well as in the backend module

For the full list, see the official documentation.

The t3sbootstrap ecosystem

t3sbootstrap is the core, but it plays nicely with a family of companion extensions:

Extension Purpose
t3sbootstrap_builder Visual Bootstrap 5.3 theme builder as a backend module — around 200 variables with live preview. Version 1.0.2 requires t3sbootstrap >= 5.3.50.
t3s_swiper Swiper slider content element, based on Content Blocks
iconpack / iconpack_fontawesome Icon picker integration (replacement for rte_ckeditor_fontawesome)

t3sb_package is no longer needed as of 5.3.50. Existing installations can keep it installed; it is simply not written to any more.

Documentation & Demos

Support the project

t3sbootstrap is developed and maintained in spare time. If you use it in commercial projects or simply find it useful, please consider supporting its development:

Donate

Bug reports, pull requests and constructive feedback are very welcome.

Author & Commercial Support

t3sbootstrap is developed and maintained by Helmut Hackbarth — freelance TYPO3 developer at t3solution.

License

This extension is released under the GNU General Public License v2.0 or later (GPL-2.0-or-later), in line with the TYPO3 Core. See LICENSE.txt for details.

Bootstrap itself is © the Bootstrap Authors and released under the MIT license.

About

Startup extension to use bootstrap 5 classes, components and more out of the box.

Resources

Readme
GPL-2.0 license
Activity

Stars

24 stars

Watchers

7 watching

Forks

22 forks
Report repository

Releases

Packages

Used by

Contributors

Languages