PHPackages                             heyblackmagic/wp-foundation - 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. heyblackmagic/wp-foundation

ActiveProject

heyblackmagic/wp-foundation
===========================

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

v1.0.0(3y ago)011MITPHPPHP >=8.0

Since May 15Pushed 3y ago1 watchersCompare

[ Source](https://github.com/wearealloy/wp-foundation)[ Packagist](https://packagist.org/packages/heyblackmagic/wp-foundation)[ Docs](https://roots.io/bedrock/)[ RSS](/packages/heyblackmagic-wp-foundation/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (13)Versions (2)Used By (0)

WP Foundation
=============

[](#wp-foundation)

Development from scratch
------------------------

[](#development-from-scratch)

1. Run `composer create-project heyblackmagic/wp-foundation ./PATH` to create a WP instance with Composer.
2. In the directory where the project was installed, run `composer update` to install plugins and composer dependencies.
3. Then run `npm install && npm run build` to install node packages and generate the asset bundle.
4. With the terminal enter the `./public_html` directory and execute `valet link VHOST_NAME`, where `VHOST_NAME` is the name of the local domain. Example: "valet link foundation".

Development continuation from git pull
--------------------------------------

[](#development-continuation-from-git-pull)

1. Pull / Clone the project.
2. Go to project folder and run the command `composer update`, `npm install` and `npm run build`.
3. Rename `env.example` to `.env` and update the variables.
4. With the terminal enter the `./public_html` directory and execute `valet link VHOST_NAME`, where `VHOST_NAME` is the name of the local domain. Example: "valet link foundation".

Directory
---------

[](#directory)

```
.
├── LICENSE.md
├── README.md
├── composer.json
├── composer.lock
├── config
│   ├── application.php
│   └── environments
│       ├── development.php
│       └── staging.php
├── package-lock.json
├── package.json
├── phpcs.xml
├── postcss.config.js
├── public_html
│   ├── app
│   │   ├── mu-plugins
│   │   │   └── bedrock-autoloader.php
│   │   ├── plugins
│   │   ├── themes
│   │   │   └── foundation
│   │   │       ├── assets
│   │   │       │   └── img.jpg
│   │   │       ├── components
│   │   │       │   ├── component-footer.php
│   │   │       │   └── component-header.php
│   │   │       ├── footer.php
│   │   │       ├── front-page.php
│   │   │       ├── functions.php
│   │   │       ├── header.php
│   │   │       ├── home.php
│   │   │       ├── inc
│   │   │       │   ├── child-items.php
│   │   │       │   ├── helpers.php
│   │   │       │   ├── menu-items.php
│   │   │       │   ├── template-functions.php
│   │   │       │   ├── vite-constants.php
│   │   │       │   ├── vite-env.php
│   │   │       │   └── vite-scripts.php
│   │   │       ├── index.php
│   │   │       ├── meta
│   │   │       │   ├── favicon.php
│   │   │       │   └── fonts.php
│   │   │       ├── page.php
│   │   │       ├── snippets
│   │   │       └── style.css
│   │   └── uploads
│   ├── index.php
│   └── wp-config.php
├── src
│   ├── js
│   │   └── app.js
│   ├── public
│   └── scss
│       ├── abstracts
│       │   ├── _mixins.scss
│       │   ├── _variables.scss
│       │   └── index.scss
│       ├── app.scss
│       ├── base
│       │   ├── _buttons.scss
│       │   ├── _helpers.scss
│       │   ├── _images.scss
│       │   ├── _reset.scss
│       │   ├── _root.scss
│       │   ├── _typography.scss
│       │   └── index.scss
│       ├── components
│       │   └── index.scss
│       ├── snippets
│       │   └── index.scss
│       ├── templates
│       │   └── index.scss
│       └── vendor
│           └── index.scss
├── templates -> public_html/app/themes/foundation
├── vite.config.js
└── wp-cli.yml
```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

1099d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/aa8eeba0adbebac6380d2dcc14235fa5166da22f8389cadd667f7cfcbc410636?d=identicon)[heyblackmagic](/maintainers/heyblackmagic)

---

Top Contributors

[![anuarhdz](https://avatars.githubusercontent.com/u/37639437?v=4)](https://github.com/anuarhdz "anuarhdz (1 commits)")

---

Tags

composerwordpresswprootsbedrockwp-config

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/heyblackmagic-wp-foundation/health.svg)

```
[![Health](https://phpackages.com/badges/heyblackmagic-wp-foundation/health.svg)](https://phpackages.com/packages/heyblackmagic-wp-foundation)
```

###  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)