PHPackages                             phycticio/wp-boilerplate - 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. phycticio/wp-boilerplate

ActiveProject[Framework](/categories/framework)

phycticio/wp-boilerplate
========================

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

v1.0.17(1y ago)28173[1 issues](https://github.com/phycticio/wp-boilerplate/issues)MITPHPPHP >=8.1CI passing

Since Feb 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/phycticio/wp-boilerplate)[ Packagist](https://packagist.org/packages/phycticio/wp-boilerplate)[ Docs](https://github.com/phycticio/wp-boilerplate)[ RSS](/packages/phycticio-wp-boilerplate/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (12)Versions (13)Used By (0)

WordPress Boilerplate Modern Stack
==================================

[](#wordpress-boilerplate-modern-stack)

[![License](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](https://mit-license.org/)[![PHP](https://camo.githubusercontent.com/b0b6d5f16e83ecdb2339571189bb6e44a49e79db7b8e5bddf8a9530c7442eb54/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d3838393242462e737667)](https://php.net/)[![WordPress](https://camo.githubusercontent.com/4e2ded1cc838c28ad3242113b7fc026a029ae9fbb199920f8d79f3a6f12d63ac/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f576f726450726573732d362e342532422d3030373361612e737667)](https://wordpress.org/)

Modern template for WordPress development with scalable architecture and updated technology stack.

Key Features
------------

[](#key-features)

- 🚀 **Modern Stack**: PHP 8.1+, Node 18+, Composer 2+, pnpm
- 🧩 **Dependency Management**:
    - Plugins managed via Composer
    - Assets with Webpack 5 and ES6+
- 🧱 **Block Theme**:
    - Native blocks with React
    - Full Site Editing (FSE)
    - Complete frontend/backend integration
- 📐 **Clean Architecture**:
    - MVC pattern with Twig templating
    - Environment-based configuration
    - Clear separation of responsibilities
- ⚙️ **Professional Workflow**:
    - Integrated GitHub Actions
    - PHP Code Standards (Pint)
    - Multi-environment Webpack

Prerequisites
-------------

[](#prerequisites)

- PHP 8.1+
- Node.js 18+
- Composer 2.2+
- pnpm 8+

Quick Installation
------------------

[](#quick-installation)

```
composer create-project phycticio/wp-boilerplate project-name
cd project-name
cp sample.env .env
pnpm install
pnpm run build
```

Configuration
-------------

[](#configuration)

### Environments

[](#environments)

1. Edit `.env` with your variables
2. Configure environments in `config/environments/`
    - `development.php`: Local config
    - `production.php`: Production config

### Main Files

[](#main-files)

- `config/application.php`: Shared configuration
- `web/wp-config.php`: WordPress Bootstrap
- `app/App.php`: Theme initializer

Directory Structure
-------------------

[](#directory-structure)

```
wp-boilerplate/
├── .github/            # GitHub Actions workflows
├── app/                # Application logic
│   ├── Features/       # Traits and functionalities
│   ├── Hooks/          # WordPress hooks
│   ├── Services/       # Services and DB interactions
│   └── App.php         # Main initializer
├── config/             # Configurations
│   ├── environments/   # Environment variables
│   ├── application.php # Base config
│   └── webpack.*.js    # Webpack configurations
├── resources/          # Assets and templates
│   ├── blocks/         # Custom blocks
│   ├── scripts/        # JS entry points
│   ├── scss/           # Global styles
│   └── views/          # Twig templates
├── web/                # Web root
│   ├── content/        # WP content directory
│   └── wp/             # Core WordPress
└── [config files]      # Global configurations

```

Development
-----------

[](#development)

### Main Commands

[](#main-commands)

```
# Install dependencies
pnpm install

# Development with hot-reload
pnpm run dev

# Production build
pnpm run build

# Lint PHP
pnpm run lint

# Format code
pnpm run format
```

### Block Creation

[](#block-creation)

1. Add new block in `resources/blocks/`
2. Use WordPress `registerBlockType`
3. Import styles/scripts in Webpack config

### Twig Templates

[](#twig-templates)

```
// Example usage in WordPress
View::render('template-name', ['data' => $values]);
```

GitHub Actions Workflow
-----------------------

[](#github-actions-workflow)

- **Lint**: PHP/JS code verification
- **Build**: Asset compilation
- **Deploy**: Configurable for different environments

Coding Standards
----------------

[](#coding-standards)

- PHP: PHP-CS-Fixer (config in `pint.json`)
- JS: ESLint with standard config
- Styles: SCSS with SMACSS structure

Contribution
------------

[](#contribution)

1. Fork the project
2. Create feature branch (`feat/my-feature`)
3. Submit Pull Request

License
-------

[](#license)

GPL-3.0. See [LICENSE](LICENSE) for details.

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for version history.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance47

Moderate activity, may be stable

Popularity17

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 98.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 ~4 days

Total

9

Last Release

422d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/25d8e818d0a4bab00b5d6aee2744ad14ddef3245da634ba961c2c9a1e05adc00?d=identicon)[orioncms](/maintainers/orioncms)

---

Top Contributors

[![phycticio](https://avatars.githubusercontent.com/u/84103108?v=4)](https://github.com/phycticio "phycticio (54 commits)")[![lury](https://avatars.githubusercontent.com/u/457190?v=4)](https://github.com/lury "lury (1 commits)")

---

Tags

composerwordpressboilerplatewpwp-configmody

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/phycticio-wp-boilerplate/health.svg)

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

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