From craft-workspace-webconsulting-skills
Manages TYPO3 DDEV setups for extension development: generates backend/landing URLs, runs ddev commands (start/stop/exec/install), handles multi-version testing (v11-14), PHP/DB configs.
npx claudepluginhub dirnbauer/webconsulting-skillsThis skill uses the workspace's default tool permissions.
**NEVER guess URLs. Read `name:` from `.ddev/config.yaml`, then apply subdomain pattern:**
assets/templates/Makefile.templateassets/templates/README-SERVICES.md.optionalassets/templates/apache/apache-site.confassets/templates/apache/docs.confassets/templates/apache/v11.confassets/templates/apache/v12.confassets/templates/apache/v13.confassets/templates/apache/v14.confassets/templates/commands/host/docsassets/templates/commands/host/pre-start-git-infoassets/templates/commands/host/setupassets/templates/commands/install-allassets/templates/commands/install-v11assets/templates/commands/install-v12assets/templates/commands/install-v13assets/templates/commands/install-v14assets/templates/commands/web/configure-extension.optionalassets/templates/commands/web/generate-indexassets/templates/commands/web/generate-makefileassets/templates/commands/web/install-introduction.optionalManages DDEV local environments for Craft CMS: config.yaml (PHP/Node/DB/docroot), shorthand commands (composer/craft/npm), add-ons (Redis/Mailpit), DB import/export, Xdebug toggle, Vite exposure, sharing, troubleshooting (logs/poweroff/delete/port conflicts).
Provides TYPO3 v14 security hardening checklist covering configuration settings, file permissions, and common vulnerabilities. Use for security audits, hardening, and permissions.
Generates Docker Compose and Dockerfile configurations for local development via interactive Q&A. Supports PHP/Laravel, WordPress, Drupal, Node.js, Python stacks with Nginx, Supervisor/PM2, databases, Redis, email testing.
Share bugs, ideas, or general feedback.
NEVER guess URLs. Read name: from .ddev/config.yaml, then apply subdomain pattern:
https://v{VERSION}.{sitename}.ddev.site/typo3/ — e.g., https://v14.my-ext.ddev.site/typo3/
Landing page: https://{sitename}.ddev.site/ · Docs: https://docs.{sitename}.ddev.site/
Each version gets its own Apache vhost (/var/www/html/v{VERSION}), routed via additional_hostnames. Check configured versions before presenting URLs. Never infer URLs from directory listings.
Credentials: admin / Joh316!!
.ddev/ exists → ddev execdocker-compose.yml → docker compose execddev start && ddev install-all # All versions (11/12/13/14)
ddev install-v14 # v14.3 LTS (default / gold standard)
ddev install-v13 # v13.4 LTS
MariaDB 10.11 (default) · SQLite (simple, no SQL) · PostgreSQL 16 (GIS) · MySQL 8.0 (Oracle parity). See references/advanced-options.md.
php_version: "8.3" in config.yaml. Upgrade via .ddev/web-build/Dockerfile (apt-get dist-upgrade). Custom settings: .ddev/php/custom.ini. See references/0003-php-version-management.md.
| v12 | v13 | v14.3 LTS | |
|---|---|---|---|
| Setup | install:setup --use-existing-database | setup | setup |
| Activation | Auto (Composer) | extension:setup | extension:setup |
composer.json | optional | optional | required (classic mode, #108310) |
| Default theme | bootstrap-package | bootstrap-package | Camino (#108539) |
| Fluid | 2.x | 4.x | 5.x strict (#108148) |
| CKEditor | 41–42 | 41–42 | 47 |
See references/typo3-12-cli-changes.md.
ddev status, ddev describe, ddev exec -d /var/www/html/v13 vendor/bin/typo3 extension:list --active. See references/post-setup-verification.md.
references/0001-valkey-default-with-redis-alternative.mdddev generate-makefile / ddev generate-index / ddev docsddev xdebug on / Cache: ddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flushHyphens for composer (nr-llm), underscores for TYPO3 key (nr_llm). Source: composer.json name.
| Issue | Solution |
|---|---|
| Port conflict | router_http_port: "8080" / router_https_port: "8443" |
| Database exists | ddev mysql -e "DROP DATABASE v13; CREATE DATABASE v13;" |
| Extension not found | ddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flush |
| Windows health check | Add /phpstatus endpoint with php-fpm.sock |
| PCOV/pecl fails | apt-get install php${PHP_VERSION}-pcov |
| PHP settings ignored | Place in .ddev/php/custom.ini |
| Full cleanup | ddev delete --omit-snapshot --yes then remove Docker volumes |
| Topic | File |
|---|---|
| Prerequisites | references/prerequisites-validation.md |
| Quick start | references/quickstart.md |
| Advanced options | references/advanced-options.md |
| Post-setup | references/post-setup-verification.md |
| Branding/landing page | references/index-page-generation.md |
| Windows | references/windows-fixes.md, references/windows-optimizations.md |
| Docs rendering | references/documentation-rendering.md |
| PHP versions | references/0003-php-version-management.md |
| Troubleshooting | references/troubleshooting.md |
This skill is based on the excellent work by Netresearch DTT GmbH.
Original repository: https://github.com/netresearch/typo3-ddev-skill
Copyright (c) Netresearch DTT GmbH — Methodology and best practices (MIT / CC-BY-SA-4.0)
Special thanks to Netresearch DTT GmbH for their generous open-source contributions to the TYPO3 community, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection