Changelog

v0.4.0 Latest

Apr 8, 2026

Subdomains are no longer handled as label of the docker container. Instead they are written to the dynamic.yaml so that traefik can apply them instantly. Previously the container needed to be recreated if the subdomain changed.
Services are no longer handled via the docker-compose.proxy.yml (like name, category, description, subdomain) but rather moved to the webdev.yml to have all configs in one place.
Additional arguments can now be passed to the test commands
New Help Screen (this will be shown when you just enter webdev). It will show now only the most common used commands and will also seperate them between running on local and within the devcontainer.
Implemented a new admin section to administrate multiple projects and their settings.
The debug mode can now be enabled globally till it is disabled, making it easier to debug the whole application as this apply to all executions of webdev like subprocesses or calls via tasks.
Rewrote the mysql update command to list all available mysql custom images and updating multiple instances at once.
Added an option for services start to force the recreation of docker services
Shell scripts can now define in which environment(host or within the container) they can run

When using Sub-Workspaces, secrets defined in their config wouldn´t load. This has been fixed
Better handling of git secrets when cloning sub workspaces
Use only lower cases for projectname otherwise docker start will fail
Ignore ZoneIdentifier Files when searching for secrets

Rewrote most classes to use interfaces and dependency injection, to make it easier to write unit tests

docker-compose.proxy.yml will no longer be needed and should be removed from the devcontainer.json
Changes in the webdev.yml regarding service definitions

Full Changelog: https://github.com/Derroylo/webdev-tool/compare/v0.3.2…v0.4.0

Nov 24, 2025

Full Changelog: https://github.com/Derroylo/webdev-tool/compare/v0.3.2…v0.3.3

Nov 23, 2025

Implemented the ability that some parts can be translated, see secrets
Added a new property to secrets “missingMessage” that can contain a custom message and explain what todo when a secret could not be found
Added a new property to secrets “expectedVars” that contains the name of the expected variables in the secret file
Added a new property to secrets “expectedSecrets” that shows what secrets should be added to a certain file.
EnvVar Secrets can now be used in custom scripts
Added the ability to add php test tools to the config, like phpstan or phpcsfixer. More under Running tests
Rewrote the shell execution so that the output from the shell will be better displayed (like ProgressBars, Colored texts etc.)

Remove invalid characters from the docker compose project name generation. A dot in the folder name would result in an invalid project name and prevent the project from starting
Fixed that “webdev services stop” did not work anymore
Fixed that the update checker was not working when using custom date formatting on the system
Fixed wrong owner of the created certs
Fixed an error that caused the webdev.yml to loose settings when changing other settings

Full Changelog: https://github.com/Derroylo/webdev-tool/compare/v0.3.1…v0.3.2