t3kit/t3kit-starter

Starter point for t3kit project. t3kit and TYPO3 dependencies, folder structure, custom site configurations, local environment based on Docker, CI/CD configs

10.0.0 2021-09-24 14:40 UTC

README

t3kit logo

t3kit-starter

Starter point for a new project based on t3kit

t3kit documentation

Table of contents

t3kit-starter

General info about t3kit project

About

t3kit-starter is a bunch of tools, configs, and best practices which should help you to kickstart new projects on a t3kit basis

What's included

  • Project folder structure
  • Composer configuration
  • t3kit and TYPO3 project dependencies
  • TYPO3 global configurations
  • TYPO3 context configurations
  • Custom site configurations
  • Local development environment based on Docker
  • Starter database
  • Tests
  • Code guidelines

Required dependencies

File structure

t3kit-starter/
├── .github/          # github actions
├── .localconf/
│   ├── community/   # community configuration for t3kit, not supported by t3kit team
│   ├── db/          # t3kit database manipulation - Setup/Restore/Pack
│   └── docker/      # t3kit local development config based on Docker
├── config/
└── public/
    ├── typo3conf/
    │   ├── AdditionalConfiguration.php
    │   ├── LocalConfiguration.php
    │   └── PackageStates.php
    └── fileadmin/

Community configuration

We are open to any additional configuration on top of the t3kit. To add it just follow two rules below:

  1. It always should be inside .localconf/community/ folder
  2. t3kit team will not support it

Clean up the project

If there no needs to use t3kit starter database or Docker configuration for local development, then just delete folder .localconf from the root of your project rm -r .localconf

Quick start a new project on t3kit base (two options)

  1. Start with composer create-project

    
    
  2. Use as a template in GitHub (recommended). If you are using GitHub to store your future project, then you can just clone t3kit-starter as a template to your new project repository with Use this template green button in t3kit organization in the t3kit-starter repository.

Start with t3kit local development

  1. Check that nginx-proxy started

  2. git clone git@github.com:t3kit/t3kit-starter.git - Clone the repository

  3. composer env - Configure local development environment variables

    *Note: To continue with Docker based local development you need to create an environment .env file for your project based on an example local.env. You can create .env file by running: composer env as described above or cp .localconf/local.env .env.

    • Check all environment variables in .env file and change them if it needed
    • OS-specific settings in .env file
      • Linux
        • Uncomment USER_ID var and set up your host user id to make the shared folder writable. (Skip this step if you are a Mac user)
  4. composer ci - Install composer dependencies

  5. npm install - Install npm dependencies

  6. npm run dev - Build development assests for themes

  7. docker compose up -d - Start all Docker services for a local development environment

  8. Setup t3kit starter database composer dbup

  9. Open t3kit11.t3.localhost in browser Google Chrome

  10. Open TYPO3 BE t3kit11.t3.localhost/typo3 ---> [user: admin, password: admin1234]

  11. Open TYPO3 Install tool t3kit11.t3.localhost/typo3/install.php ---> [password: admin1234]

Create your custom theme based on t3kit to extend the functionality.

public/typo3conf/ext/theme_newcustomproject in this folder you can find an example of TYPO3 extension that can be a good starting point for extending the default t3kit theme. With this "subtheme" extension, you can change the design and add the necessary content elements while maintaining the main features of t3kit, and the ability to easily upgrade to newer versions of TYPO3 and t3kit.

Quick start

  1. Define a name for your new theme. For example, let's take the name mega

  2. Create a new extension based on theme_newcustomproject

    cp -r public/typo3conf/ext/theme_newcustomproject public/typo3conf/ext/theme_mega

    Note: Change the mega part in public/typo3conf/ext/theme_mega to your real project neme

  3. Rename newcustomproject to your project name. In our example, we are using mega as a project name.

    • Mac
        grep -rl 'newcustomproject' public/typo3conf/ext/theme_mega | xargs sed -i '' 's/newcustomproject/mega/g'
    • Linux
        grep -rl 'newcustomproject' public/typo3conf/ext/theme_mega | xargs sed -i 's/newcustomproject/mega/g'

Note: Change the mega part in **/ext/theme_mega and s/newcustomproject/mega/g to your real project neme 4. Add new composer autoload config to the root composer.json for your new extension. - "T3k\\mega\\": "public/typo3conf/ext/theme_mega/Classes/"

  1. npm install - Install npm dependencies.
  2. npm run build - Build development assests for themes.

Local development tools

t3kit database manipulation - Setup/Restore/Pack

  • Setup t3kit db: composer dbup
  • Restore t3kit db: composer dbre
  • Pack (save) t3kit db: composer dbp

phpMyAdmin

Run phpMyAdmin docker container and connect it to needed DB host

docker run --name pma -d -e PMA_ARBITRARY=1 --restart=unless-stopped --network nproxy -p 8083:80 phpmyadmin/phpmyadmin

nginx-proxy

nginx-proxy for t3kit11 project

For all t3kit projects, we need just a one nginx-proxy started as a separate Docker container. Based on Automated Nginx Reverse Proxy for Docker

Run nproxy with docker compose
git clone git@github.com:t3kit/nproxy.git
cd nproxy
docker compose up -d

Community-contributed platforms

These platforms are not officially supported by the t3kit team.