Published on

Use GitLab TYPO3 Project Template

Authors

GitLab ships a TYPO3 project template that jumpstarts new projects with a working setup and pipeline.

Create from template

  • In GitLab, click New Project → Create from template → TYPO3
  • Pick a name/namespace and create the project

Run locally (Docker)

Most templates include a docker-compose.yml or instructions. Typical workflow:

git clone git@gitlab.com:your-namespace/your-typo3-project.git
cd your-typo3-project
# Adjust .env / docker compose as needed
docker compose up -d

Open the app in your browser and finish the TYPO3 install wizard.

CI/CD pipeline

The template comes with a .gitlab-ci.yml to lint, build, and run tests.

Common stages:

  • composer install & cache vendors
  • PHP lint/static analysis
  • unit/functional tests
  • build artifacts (e.g. frontend)
  • deploy

Customize the jobs for your hosting and branching strategy.

Tips

  • Store secrets in GitLab CI variables (DSN, database creds, etc.)
  • Use Composer scripts to standardize tasks (coding standards, tests)
  • Add a Makefile for a friendly DX (e.g. make up, make test)

Conclusion

Using GitLab’s TYPO3 template can save hours of setup and provides a solid base with CI out-of-the-box.