An Update on the TYPO3’s GitLab Project Template
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.
Tip: A page on how to create a TYPO3 project from the official GitLab template is now also available in the TYPO3 Documentation.
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
- Support .env files — Simplify configuration handling
- DDEV Provider — Download DB and files from Live/Staging environments
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.
Updated 25 June 2025 to include a tip about the page in the TYPO3 Documentation.
Author
Jochen
Created by