Creating a TYPO3 project from the official GitLab template

Create from template

Go to page GitLab - New from template or to path /new#create_from_template on your self-hosted GitLab. And chose TYPO3 Distribution from the list:

Fill in project details

Clone the project

Clone the project to your local machine. You can download the SSH link from the Code dropdown:

Then clone the repository:

git clone git@gitlab.com:linawolf/getting-started-with-the-gitlab-template.git

Start DDEV and setup TYPO3

You can start and setup the project locally in DDEV using the built-in command:

ddev typo3-init

See also file Readme.md in the root of your project.

This step automatically creates several files that should be added to git:

$ git status
On branch main
Your branch is up to date with 'origin/main'.

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        composer.lock
        config/sites/
        package-lock.json

nothing added to commit but untracked files present (use "git add" to track)

$ git add .

:file:`composer.lock`
    This file contains the information which exact versions of PHP packages
    are installed.
:file:`package-lock.json`
    This file contains the information which exact versions of npm packages
    are installed.
:file:`config/sites/`
    Contains configuration and settings of the site that was created during
    setup.

Log into the TYPO3 backend

If allowed by your system the TYPO3 backend login will be automatically opened in a browser. Otherwise you can open a browser of your choice with the link displayed in the console.

A default user has been created. Username and password are displayed in your console.

Once logged in, you can preview a page and see it rendered with a basic theme.

Directory structure of the project