An Update on the TYPO3’s GitLab Project Template

Categories: Development, Community, TYPO3 CMS Created by Jochen
A red arrow points to the TYPO3 Distribution option in a GitLab project template selection menu, which is described as "A template for starting a new TYPO3 project".
A lot has happened since the TYPO3 GitLab Project Template was first introduced in 2023. Jochen Roth shares the latest on this community-driven effort to streamline project setup, reduce complexity, and introduce powerful new features to the GitLab Project Template for TYPO3.

Check Out the GitLab Project Template for TYPO3

Automated Setup

The setup is now completely automated. The required DDEV add-ons are installed automatically along with the Composer and npm packages. Once the repository is cloned, the following command will prepare everything for you:

ddev typo3-init

Vite Bundler

We switched from Webpack to Vite for an easier, faster and more maintainable configuration with fewer dependencies.

Thanks to Simon Praetorius's Vite Asset Collector (vite_asset_collector) and the DDEV Vite Sidecar. This made it easy to integrate the Vite generated assets into TYPO3 and enable Hot Module Replacement (HMR) when needed with ddev vite.

Scheduler

The cron job required for the Scheduler (scheduler) core extension is now pre-configured and running every 5 minutes.

When Xdebug is enabled (ddev xdebug on), the cron job will not be executed but can still be triggered manually using ddev typo3-scheduler -f .

Documentation

At first, the README file was sufficient. But over time, it grew longer and longer as more details were added. We've decided to write documentation that not only includes a guide on how to use the template but also provides recommendations and best practices. See our shiny docs site.

Test, Test, Test ...

The template is now covered by Playwright end-to-end tests to ensure it remains in a working state. Each merge request undergoes automated testing, in addition to regular weekly testing.

The tests are executed inside DDEV within the GitLab CI using the official DDEV GitLab CI Container image.

Features Currently Work In Progress

Start Your Next TYPO3 Project With a Template

Are you keen? Head over to a GitLab instance near you and create a new project and select Create from template.

If you encounter issues or just want to contribute, see the official TYPO3 Project in GitLab.

Additional contributors for this article