PHPackages feryardiant/wpdev - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. feryardiant/wpdev AbandonedArchivedProject[Framework](/categories/framework) feryardiant/wpdev ================= WordPress boilerplate based-on Bedrock by Roots. v0.2.9(5y ago)9145[3 issues](https://github.com/feryardiant/learn-wpdev/issues)[9 PRs](https://github.com/feryardiant/learn-wpdev/pulls)MITPHPPHP >=7.1CI passing Since Sep 12Pushed 3w ago3 watchersCompare [ Source](https://github.com/feryardiant/learn-wpdev)[ Packagist](https://packagist.org/packages/feryardiant/wpdev)[ Docs](https://github.com/feryardiant/wpdev/)[ Fund](http://paypal.me/feryardiant)[ GitHub Sponsors](https://github.com/feryardiant)[ RSS](/packages/feryardiant-wpdev/feed)WikiDiscussions main Synced 3d ago READMEChangelog (10)Dependencies (25)Versions (36)Used By (0) My Personal WordPress Project Boilerplate [![Actions Status](https://github.com/feryardiant/wpdev/workflows/Tests%20and%20Build/badge.svg)](https://github.com/feryardiant/wpdev/actions) ========================================================================================================================================================================================= [](#my-personal-wordpress-project-boilerplate-) This project aims to provide complete solution for WordPress development and deployment to heroku, even though it isn't completed just yet. 😬 Inspired by [wordpress-heroku](https://github.com/PhilippHeuer/wordpress-heroku) by Phillip Heuer and based on the exact same boilerplate of [Bedrock](https://roots.io/bedrock/), this project will give you better experiences while developing your very own WordPress themes and plugins that easily deployed to heroku. Features -------- [](#features) - Integrated Unit and end-to-end testing - Custom [heroku buildpack](https://devcenter.heroku.com/articles/buildpack-api) - Automated changelog generator - Better assets compilation - Easily create archive that ready to distribute to WordPress themes or plugins directory - Thoughts? [let me know](https://github.com/feryardiant/wpdev/issues/new) 😁 Requirements ------------ [](#requirements) - PHP >= 7.1 - Composer - [Install](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx) - Gulp - [Install](https://gulpjs.com/docs/en/getting-started/quick-start#install-the-gulp-command-line-utility) Its always good to have WP-CLI [installed globally](https://wp-cli.org/#installing) on your system. For Database and HTTP Server requirements please refer to [this documentation](https://wordpress.org/about/requirements). Installation ------------ [](#installation) ### 1. One-Click-Deployment [](#1-one-click-deployment) [![Deploy](https://camo.githubusercontent.com/4eea217b02568cc464752586784ae247b22e99fea520a15b6f919b15934ba8ca/68747470733a2f2f7777772e6865726f6b7563646e2e636f6d2f6465706c6f792f627574746f6e2e737667)](https://heroku.com/deploy?template=https://github.com/feryardiant/wpdev/tree/master) Using this button you can deploy a new instance of WordPress. All required extensions will be deployed automatically. This also works if you fork your own project to work on your site. ### 2. Using `composer create-project` command [](#2-using-composer-create-project-command) ``` $ composer create-project feryardiant/wpdev [project-folder] ``` Create new database through PHPMyAdmin or from CLI ``` $ mysql -u[username] -p -e 'create database ' ``` Configure your `.env` file to suit your local setup, described [here](https://roots.io/bedrock/docs/installing-bedrock), also don't forget to set the `url` key on `wp-cli.local.yml` file as well. Once you're done, let's install WordPress core with the following command: ``` # Please consult to the official documentation for additional option you might needed for the setup # See: https://developer.wordpress.org/cli/commands/core/install/ $ vendor/bin/wp core install # Or you can simply run the following sortcut $ composer wp:install ``` Please make sure to configure your HTTP server' `document root` to `public` directory. ### Development [](#development) I using `gulp` for almost all development workflow in this project, not only for compiling `scss` files, minify images and compressing `js`, but also to run development server. Once you're done with installation process above, please install the development dependencies through `yarn` ``` $ yarn ``` To start the development server you can simply run command below: ``` # yarn global add glup-cli or npm -g install gulp-cli, in case you don't have one $ gulp ``` The gulp default task will fire up [PHP Developent Server](https://www.php.net/manual/en/features.commandline.webserver.php), start BrowserSync on port `3000` and watch the changes you made. That way, all you need to do is open your web browser and type [`http://localhost:3000`](http://locahost:3000) on the address bar, open the project on your favorite code editor or IDE and start working. All the changes you've made will be automatically linted and compiled, once it done BrowserSync will reload the browser for you. Workflow -------- [](#workflow) Since this project is based on [Bedrock](https://roots.io/bedrock/docs/folder-structure/), the project directory structure is pretty much similar, but with some tweaks. ### Directory Structure and Gulp tasks [](#directory-structure-and-gulp-tasks) - **bin** directory : Consists of all [buildpack executables](https://devcenter.heroku.com/articles/buildpack-api#buildpack-api) only, feel free to delete this directory once you've cloned this project or install it on your local machine, - **config** directory : Consists of all build utilities and configuration files, including all the scripts you'd be using on all environment, - **public** directory : The server document root directory, - **packages** directory : The Themes and Plugins development directory of your project, - **tests** directory : Testing directory, obviously. ``` ├── bin ├── config │   ├── environments │   └── heroku ├── public │   ├── app │   └── wp ├── packages ├── resources └── tests ├── e2e ├── stubs └── unit ``` The `gulp` scripts will autoatically scan any sub-directories under `plugins` and `themes` and generate all the required `gulp` tasks if the sub-directory meets the following structures: ``` ├── assets │   ├── img │   ├── js │   └── scss └── languages ``` Once you've create `` above inside `plugins` or `themes` directory, you'll see similar gulp tasks as following: ``` $ gulp -T ├── theme-plugin:php ├── theme-plugin:zip ├─┬ theme-plugin:build │ └─┬ │   └── theme-plugin:php ├── theme:php ├── theme:img ├── theme:css ├── theme:js ├── theme:zip ├─┬ theme:build │ └─┬ │   ├── theme:css │   ├── theme:img │   ├── theme:js │   └── theme:php ├── theme-child:php ├── theme-child:zip ├─┬ theme-child:build │ └─┬ │   └── theme-child:php ├─┬ zip │ └─┬ │   ├── theme-plugin:zip │   ├── theme:zip │   └── theme-child:zip ├─┬ build │ └─┬ │   ├── theme-child:php │   ├── theme-plugin:php │   ├── theme:css │   ├── theme:img │   ├── theme:js │   └── theme:php ├── e2e ├── release └── default ``` ### Notes [](#notes) - `:build` task will execute all task under `` namespace, except for `:zip` task. - Each `*:css`, `*:img` and `*:js` will only available if you have `img`, `js` and `scss` directories under `assets` directory. - `build` task will combine all `*:build` tasks on each namespace. - `zip` task will combine all `*:zip` tasks on each namespace. - `release` task will run `build` task, generate `CHANGELOG.md`, run `zip` task and bump version number of this project. Sponsors -------- [](#sponsors) - [BrowserStack](https://browserstack.com) Credits ------- [](#credits) - [WordPress](https://wordpress.org/) - [GPLv2 License](https://wordpress.org/about/license/) - [Bedrock](https://roots.io/bedrock/) - [MIT License](https://github.com/roots/bedrock/blob/master/LICENSE.md) - [Underscores](https://underscores.me) - [GPLv2 License](https://github.com/Automattic/_s/blob/master/LICENSE) - [Bulma](https://bulma.io) - [MIT License](https://github.com/jgthms/bulma/blob/master/LICENSE) - [Gulp](https://gulpjs.com) and its plugins - [BrowserSync](https://browsersync.io) License ------- [](#license) (c) 2019 Fery Wardiyanto - [MIT license](LICENSE). ### Health Score 37 — LowBetter than 83% of packages Maintenance56 Moderate activity, may be stable Popularity14 Limited adoption so far Community15 Small or concentrated contributor base Maturity54 Maturing project, gaining track record Bus Factor1 Top contributor holds 77.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~16 days Recently: every ~56 days Total 18 Last Release 2162d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/16384dbbd6cd66f33f13f5bf2dc7f26125049762c7414eb0e755c630375240ba?d=identicon)[feryardiant](/maintainers/feryardiant) --- Top Contributors [![feryardiant](https://avatars.githubusercontent.com/u/508665?v=4)](https://github.com/feryardiant "feryardiant (1018 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (226 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (58 commits)")[![creasi](https://avatars.githubusercontent.com/u/11495172?v=4)](https://github.com/creasi "creasi (16 commits)") --- Tags bedrockboilerplateherokuheroku-buildpacklearningwordpressworkflowcomposerwordpressboilerplaterootsbedrockwp-config ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/feryardiant-wpdev/health.svg) ``` [![Health](https://phpackages.com/badges/feryardiant-wpdev/health.svg)](https://phpackages.com/packages/feryardiant-wpdev) ``` ### Alternatives [roots/bedrock WordPress boilerplate with Composer, easier configuration, and an improved folder structure 6.5k441.8k2](/packages/roots-bedrock) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)