---
title: GitLab’s Built-In TYPO3 Project Template
url: "https://news.typo3.com/article/gitlabs-built-in-typo3-project-template"
description: GitLab 15.7 and newer ships with a built-in TYPO3 template for gitlab.com and self-hosted instances. The template is aimed at professionals and includes a deployment workflow using Composer and GitLab CI.
image: "https://news.typo3.com/_assets/d1e01514e4c4a5b3147940fa2ec50682/Images/og-image-news.jpg"
date: 2026-06-11
modified: 2026-06-11
categories:
  - "Developer & Technology"
  - "Showcase & Success"
  - "Product Updates & Roadmap"
---

# GitLab’s Built-In TYPO3 Project Template

- [Showcase & Success](https://news.typo3.com/article/category/showcase-success)
- [Developer & Technology](https://news.typo3.com/article/category/developer-technology)
- [Product Updates & Roadmap](https://news.typo3.com/article/category/product-updates-roadmap)

GitLab’s Built-In TYPO3 Project Template
========================================

01 August 2023

![](https://news.typo3.com/fileadmin/_processed_/c/4/csm_Gitlab-template-selection-2_cca834d0cd.webp)

GitLab 15.7 and newer ships with a built-in TYPO3 template for gitlab.com and self-hosted instances. The template is aimed at professionals and includes a deployment workflow using Composer and GitLab CI.

- ![](https://news.typo3.com/typo3temp/assets/t3g/blog/gravatar/bbf959d8e683550c90ae922aff9145d8.jpeg)[Jochen Roth](https://news.typo3.com/article/author/jochen-roth)

Using the new template is easy: Just create a new project and select *Create from template*. GitLab will show a list of available templates. Locate the *TYPO3 Distribution* and hit the *Use Template* button. Give your project a name and Gitlab will import the project for you. This allows you to have a "ready-to-code install" in almost no time.

[Start a New TYPO3 GitLab Project Now](https://gitlab.com/projects/new#create_from_template)   [Video: Watch the Complete Setup Process](https://youtu.be/teQoulFm0CU)

Tools
-----

The template uses these tools:

- [DDEV](https://ddev.com/): For a local environment with PHP, web server, and database
- [NPM/Webpack](https://www.npmjs.com/package/webpack): Compile frontend assets like CSS and JavaScript
- [Deployer](https://deployer.org/): Deploy the application to the server

Project Setup
-------------

After the project has been cloned, run these commands from within the *projects* folder. Don't forget to give the DDEV project a suitable name.

> ```
>
>     ddev config --project-name=my-typo3 --project-type=typo3
>     ddev composer install
>     touch public/FIRST_INSTALL
>     ddev start
> ```

Now TYPO3 is running, but the frontend still needs initialization.

> ```
>
>     npm install
>     npm run build:production
>     ddev composer dumpautoload # Required to publish _assets
>     ddev typo3 extension:setup # Initialize page tree and content
> ```

That's it.

Code Analysis & Quality
---------------------------

The template ships with a basic configuration for [PHPStan](https://phpstan.org/) and [CS-Fixer](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer). You can run them
 locally:

**PHPStan:**

```

    ./vendor/bin/phpstan analyse -c .phpstan.neon --no-progress
```

**CS-Fixer:**

```

    ./vendor/bin/php-cs-fixer fix --dry-run --diff
```

Deployment
----------

The deployment workflow uses [GitLab CI](https://docs.gitlab.com/ee/ci/) (see *.gitlab-ci.yml*) together with [Deployer](https://deployer.org/). Take a look at *deploy.yaml* in the project root and change it to your needs.

Watch the Complete Setup Process
--------------------------------

 Consent Required

To load this YouTube Video content, associated cookies must be accepted.

  Accept and load

Do You Feel Like Anything Is Missing?
-------------------------------------

Everyone can contribute to the [Project Template Repository](https://gitlab.com/gitlab-org/project-templates/typo3-distribution/activity) to make the template even better.

![](https://news.typo3.com/typo3temp/assets/t3g/blog/gravatar/b5c88386e5b1d8fca79d0652427922d2.jpeg)

About the Author

[Jochen Roth](https://news.typo3.com/article/author/jochen-roth)

[More posts by this author](https://news.typo3.com/article/author/jochen-roth)

Additional contributors
-----------------------

- Copy Editor
    - ![](https://news.typo3.com/typo3temp/assets/t3g/blog/gravatar/49aa12815610e985a3a94122712538f2.jpeg)Felicity Brand
- Publisher
    - ![](https://news.typo3.com/typo3temp/assets/t3g/blog/gravatar/d2606120ccc43c7846fe40337be2bc1e.png)Mathias Bolt Lesniak
- Artwork
    - ![](https://news.typo3.com/fileadmin/_processed_/2/0/csm_tom_4a1651ce02.webp)Tom Warwick