---

t3kit v7 on branch t3kit7

Previous version of t3kit v7 you can find on branch t3kit7, or you can use git tags to chose needed version:

git checkout 7.11.3
or
git checkout 7.10.0

this message will be here until stable version of t3kit v8

---

t3kit v8 (BETA)

Starter kit for TYPO3 CMS. Tools, extensions, configurations and templates.

---

• Development
• Production
• t3kit structure
• t3kit versioning
• CHANGELOG
• Contributing to t3kit

---

Development

Required dependencies:

• Git
• Composer
• Docker

Setup development environment:

Start using git:

git clone https://github.com/t3kit/t3kit.git
cd t3kit
composer install --ignore-platform-reqs
# Note for MAC users there a specific commands further down in the documentation
docker-compose up -d
docker exec -it web /t3kit_db/setupdb.sh

Start using composer:

composer create-project t3kit/t3kit t3kit dev-master --keep-vcs --ignore-platform-reqs
cd t3kit
docker-compose up -d
docker exec -it web /t3kit_db/setupdb.sh

t3kit database manipulation - Setup/Restore/Pack:

• Setup t3kit db: docker exec -it web /t3kit_db/setupdb.sh
• Restore t3kit db: docker exec -it web /t3kit_db/restoredb.sh
• Pack (save) t3kit db: docker exec -it web /t3kit_db/packdb.sh

phpMyAdmin

Run phpMyAdmin docker container and connect it to t3kit:

docker run --name phpmyadmin -dp 8889:80 --network t3kit_default --rm -e PMA_HOST=db phpmyadmin/phpmyadmin

• t3kit_default - default docker network name based on t3kit folder name.
• db - default t3kit database host name (from docker-compose).

---

Production

Required dependencies:

• Composer

Create new project based on t3kit:

composer create-project t3kit/t3kit [<directory>] [<version>] --prefer-dist --no-dev

t3kit structure

...

t3kit versioning

• t3kit v8 development is on master branch.
• t3kit v7 development is on t3kit7 branch.
• Every release synchronized with specific release of TYPO3.
• Every release tagged by git tag using Semantic Versioning
• Major version should be almost always the same as on TYPO3.

Example:

• t3kit version 7.9.12

  • 7 - major version: version of TYPO3
  • 9 - minor version: new features in t3kit
  • 12 - patch version: bug fixes, documentation updates, code refactoring, new tests in t3kit

• t3kit version 8.1.2

  • 8 - major version: version of TYPO3
  • 1 - minor version: new features in t3kit
  • 2 - patch version: bug fixes, documentation updates, code refactoring, new tests in t3kit

When we starting new major version of t3kit previous will be moved to new branch, so in this case we can keep developing new and support old one.

Examples:

• Branch master => last t3kit release t3kit 8.1.3 = TYPO3 8.6.1
• Branch t3kit7 => last t3kit release t3kit 7.11.3 = TYPO3 7.6.15

---

Docker-compose for mac users:

Native docker has some performance issues on mac:

• docker/for-mac#77
• https://docs.docker.com/docker-for-mac/osxfs/#performance-issues-solutions-and-roadmap

We suggest to use docker-sync as a temporary solution.

Instead of using docker-compose.yml you can try to use alternative docker-compose configuration docker-compose.mac.yml + docker-sync.yml

Start containers:

cd t3kit
docker-sync start -d
docker-compose -f docker-compose.mac.yml up -d

Stop containers:

docker-sync clean
docker-compose stop

Note: To fix issues with permission: docker exec -it web chown -R www-data /var/www/html