{"id":18383093,"url":"https://github.com/timkelty/craft-dev","last_synced_at":"2026-02-24T20:37:41.540Z","repository":{"id":217992134,"uuid":"744796987","full_name":"timkelty/craft-dev","owner":"timkelty","description":"Craft CMS Development","archived":false,"fork":false,"pushed_at":"2025-05-08T10:55:25.000Z","size":25991,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"4.x","last_synced_at":"2025-05-08T11:43:39.454Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Twig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timkelty.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-01-18T02:44:13.000Z","updated_at":"2025-05-08T10:55:08.000Z","dependencies_parsed_at":"2024-04-22T17:13:52.293Z","dependency_job_id":"a1905f05-dca6-47dc-a201-5567ca6e9916","html_url":"https://github.com/timkelty/craft-dev","commit_stats":null,"previous_names":["timkelty/craft-dev"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/timkelty/craft-dev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timkelty%2Fcraft-dev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timkelty%2Fcraft-dev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timkelty%2Fcraft-dev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timkelty%2Fcraft-dev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timkelty","download_url":"https://codeload.github.com/timkelty/craft-dev/tar.gz/refs/heads/4.x","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timkelty%2Fcraft-dev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29799210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T19:56:48.334Z","status":"ssl_error","status_checked_at":"2026-02-24T19:55:43.372Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T01:10:01.138Z","updated_at":"2026-02-24T20:37:41.498Z","avatar_url":"https://github.com/timkelty.png","language":"Twig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# craft-dev\n\nA DDEV-based development environment for Craft CMS.\n\n## Requirements\n\n- DDEV\n- Orbstack (not technically required, but as we will be make use of bind-mounts, it is highly recommended)\n\n## Setup\n\n### Disable Mutagen\n\nWhen using Orbstack, you likely don't want to be using Mutagen, which is enabled by default. To disabled for existing and future projects:\n\n```shell\nddev mutagen reset \u0026\u0026 ddev config global --performance-mode=none \u0026\u0026 ddev config --performance-mode=none\n```\n\n### Clone packages\n\nClone the packages you want to work on into a canonical location, e.g.:\n\n```shell\ngit clone --branch v3 git@github.com:craftcms/cms.git ~/Dev/craftcms-3\ngit clone --branch develop git@github.com:craftcms/cms.git ~/Dev/craftcms-4\ngit clone --branch 5.0 git@github.com:craftcms/cms.git ~/Dev/craftcms-5\ngit clone --branch develop git@github.com:craftcms/commerce.git ~/Dev/commerce-4\n``` \n\n### Create projects\n\nClone this project, create a new one, or use an existing one.\nIf cloning this project, there are branches for each major version of Craft:\n\n```shell\ngit clone --branch 3.x git@github.com:timkelty/craft-dev.git ~/Dev/craft-3-project\ngit clone --branch 4.x git@github.com:timkelty/craft-dev.git ~/Dev/craft-4-project\ngit clone --branch 5.x git@github.com:timkelty/craft-dev.git ~/Dev/craft-5-project\n```\n\n### Composer\n\nWithin your project, run:\n\n```shell\ncomposer config repositories.local --json '{\n  \"type\": \"path\",\n  \"url\": \"/tmp/packages/*\",\n  \"options\": {\n    \"symlink\": true\n  }\n}'\n```\n\n### DDEV\n\nWith your project running (`ddev start`), run:\n\n```shell\nddev describe -j | jq --raw-output .raw.services.db.host_ports\n```\n\nCopy the returned integer.\n\n#### .ddev/config.local.yaml\n\n```shell\ncp .ddev/config.local.yaml.example .ddev/config.local.yaml\n```\n\nPaste the value from above as the value of `host_db_port`.\nThis will lock this project to that port, so you can save it in TablePlus or wherever.\n\n#### .ddev/docker-compose.local.yaml\n\n```shell\ncp .ddev/docker-compose.local.yaml.example .ddev/docker-compose.local.yaml\n```\nModify the `volumes` list to include any paths to checked out repos you'd like to work on.\n\n  - On the left side of the `:` is the path on your host machine. Change this to the path of your checked out package repos.\n  - On the right side of the `:` is the path within the container. This can be anything, so long as it resides in `/tmp/packages/*`.\n\n## PhpStorm Settings\n\n### Attach Projects\n\nFor each package repo you want to work on, attach it via `File -\u003e Attach project…`.\n\n- Funny things happen if you attached project have `.`s in them.\n- If `Attach Project…` isn't appearing, try the normal `Open…` dialog. It should ask you if you want to attach it. \n\n![attach-project.png](storage/docs/attach-project.png)\n\nIt should end up looking something like this:\n\n![attach-project.png](storage/docs/attached-projects-sidebar.png)\n\n\n### `PHP -\u003e Composer`\n\n- uncheck `Add packages as libraries`\n\n![php-composer.png](storage/docs/php-composer.png)\n\n### `PHP -\u003e Debug`\n\n- remove `9000` from `Xdebug -\u003e Debug port` (optional)\n  - 9000 is no longer the default port for Xdebug and often conflicts with other services.\n- uncheck `Force break at first line when no path mapping specified` (optional)\n- uncheck `Force break at first line when a script is outside the project` (optional)\n\n![php-debug.png](storage/docs/php-debug.png)\n\n### `PHP -\u003e Servers -\u003e Path Mappings`\n\n- For your _additional_ project roots (i.e. composer packages):\n  - Absolute path on the server: `/tmp/packages/\u003cpackage-name\u003e`, e.g. `/tmp/packages/craft-4`\n\n![php-servers-default.png](storage/docs/php-servers-default.png)\n![php-servers-bref.png](storage/docs/php-servers-bref.png)\n\n### `PHP -\u003e Directories`\n\n- Ensure `vendor` is marked as `Excluded` for each of your _additional_ project roots (i.e. composer packages).\n\n![directories.png](storage/docs/directories.png)\n\n### `Languages \u0026 Frameworks -\u003e JavaScript -\u003e Libraries`\n\n- Add an entry and include the `src` directory of each of your _additional_ project roots (i.e. composer packages). Selecting the `src` directory prevents PhpStorm from indexing the vendor directory and contaminating PHP definitions.\n\n![javascript-libraries.png](storage/docs/javascript-libraries.png)\n\n### `PHP -\u003e Include Path`\n\n- Ensure this is **empty**. If not, remove all entries.\n\n![php.png](storage/docs/php.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimkelty%2Fcraft-dev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimkelty%2Fcraft-dev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimkelty%2Fcraft-dev/lists"}