{"id":22009826,"url":"https://github.com/herm71/site-wordpress","last_synced_at":"2026-05-08T04:14:18.780Z","repository":{"id":56037336,"uuid":"419383638","full_name":"Herm71/site-wordpress","owner":"Herm71","description":"WordPress dev env using wp-env and mapping themes and plugins folders outside","archived":false,"fork":false,"pushed_at":"2024-07-16T20:00:25.000Z","size":2584,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-10T12:47:43.239Z","etag":null,"topics":["wordpress","wp-env"],"latest_commit_sha":null,"homepage":"","language":null,"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/Herm71.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2021-10-20T15:17:40.000Z","updated_at":"2024-02-22T00:35:41.000Z","dependencies_parsed_at":"2024-07-17T00:09:17.747Z","dependency_job_id":null,"html_url":"https://github.com/Herm71/site-wordpress","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Herm71/site-wordpress","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Herm71%2Fsite-wordpress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Herm71%2Fsite-wordpress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Herm71%2Fsite-wordpress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Herm71%2Fsite-wordpress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Herm71","download_url":"https://codeload.github.com/Herm71/site-wordpress/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Herm71%2Fsite-wordpress/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265998912,"owners_count":23862215,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["wordpress","wp-env"],"created_at":"2024-11-30T02:10:56.021Z","updated_at":"2026-05-08T04:14:13.731Z","avatar_url":"https://github.com/Herm71.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# [@Herm71](https://github.com/Herm71)'s WordPress WP-ENV Dev Environment\n\nThis workflow assumes you have [Docker](https://www.docker.com/) running and [npm](https://www.npmjs.com/) installed.\n\nIf [wp-env](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/) is not installed globally, the command `npm install` will install it locally and provide a `wp-env` script for running `wp-env`.\n\nThis setup maps `wp-content/themes` to a separate working directory outside this environment. This enables working on themes outside this `root` directory, which is my preferred development workflow.\n\n## Recommendations\n\n- [Block editor](https://developer.wordpress.org/block-editor/how-to-guides/themes/block-theme-overview/) currently requires the [Gutenberg plugin](https://github.com/WordPress/gutenberg)\n- [Theme Unit Test](https://codex.wordpress.org/Theme_Unit_Test), a WordPress export (WXR) file that you can import into a WordPress installation to test your theme\n\n## Features\n\n- `.wp-env.json` that maps theme development directory *outside* this `root` environment\n- `.htaccess` file for adjusting site (eg., \"pretty permalinks\")\n- [WordPress Importer](https://wordpress.org/plugins/wordpress-importer/) plugin for importing default content (such as [Theme Unit Test](https://codex.wordpress.org/Theme_Unit_Test)).\n- [Theme Check](https://wordpress.org/plugins/theme-check/) plugin for testing theme against the latest WordPress theme standards and practices\n\n## Install\n\n- clone this repo to a directory (eg., `wp-env-site-root/`) and `cd` into it\n- run command: `npm install` or `npm i`\n- edit `.wp-env.json` to add your dev theme directory as described [below](#edit-wp-env.json)\n- run command: `npm run wp-env start` (or simply `wp-env start` if you already have `wp-env` installed globally)\n- visit your new site at [http://localhost:8888/](http://localhost:8888/)\n- login to the [Dashboard](http://localhost:8888/wp-admin)\n    - default username: `admin`\n    - default password: `password`\n- activate development theme via Dashboard-\u003eAppearance-\u003eThemes\n\nYour working environment directory setup should look like this after build:\n\n```text\nwp-env-site-root/\n  |---.wp-env.json\n  |---.htaccess\n  |---mu-plugins/\n  |---plugins/\n    |---theme-check/\n    |---wordpress-importer/\n  |---mu-plugins/\n  |---themes/ # any themes pulled in via git in .wp-env.json. Not dev theme.\ndev-theme-dir/\n  |--[dev theme directory location set up in .wp-env.json]\n```\n\n## Edit wp-env.json\n\nEdit the `\"mappings\":\"wp-content/themes\":` value in `.wp-env.json` to point to your theme development directory. Your theme will be loaded but not activated in the site's dashboard.\n\nIf you were working on a plugin you could add an additional key for `\"wp-content/plugins\":` to the `\"mappings\":` array to point to a development plugin directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fherm71%2Fsite-wordpress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fherm71%2Fsite-wordpress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fherm71%2Fsite-wordpress/lists"}