name: typo3-ddev
description: "Agent Skill: DDEV setup for TYPO3 extension development. Use when setting up local dev environment or multi-version testing (11.5/12.4/13.4/14.0). By Netresearch."

TYPO3 DDEV Setup Skill

Automates DDEV environment for TYPO3 extension development with multi-version testing.

When to Use

• Setting up DDEV for a TYPO3 extension project
• Testing extension across multiple TYPO3 versions
• Quick development environment spin-up

Container Priority

Always check for existing containers first:

1. Check .ddev/ exists → use ddev exec
2. Check docker-compose.yml exists → use docker compose exec
3. Only use system tools if no container environment

Critical: Use the project's configured PHP version, not system PHP.

Quick Start

scripts/validate-prerequisites.sh    # Check Docker, DDEV
ddev start
ddev install-all                     # All versions (11/12/13/14)
ddev install-v13                     # Single version

Access URLs

Credentials: admin / Joh316!

Generated Files

Copy templates from assets/templates/ to project's .ddev/:

.ddev/
├── config.yaml
├── docker-compose.web.yaml
├── apache/
│   ├── apache-site.conf     (main site - gitignored by ddev!)
│   ├── v12.conf             (committable - copy for TYPO3 v12)
│   ├── v13.conf             (committable - copy for TYPO3 v13)
│   └── docs.conf            (committable - for docs subdomain)
├── index.html.netresearch.template  (for netresearch/* packages)
├── index.html.typo3.template        (for all other packages)
└── commands/web/install-v{11,12,13,14}

IMPORTANT: apache-site.conf is gitignored by ddev's default .gitignore.
For multi-version setups, copy the separate v{11,12,13,14}.conf files which CAN be committed.

Optional Commands

ddev generate-makefile    # Creates make up/test/lint/ci
ddev generate-index       # Overview dashboard
ddev docs                 # Render Documentation/*.rst

Troubleshooting

References

Contributing: https://github.com/netresearch/typo3-ddev-skill