Bedrock v2

[retlehs]

Bedrock will be getting a major version update 💥 We'll be making changes to the directory structure and configuration system to better align with modern PHP practices.

These directory changes mean we'll need to update Trellis to accommodate the new structure. It will also mean we'll need to update any other tools that interact with Bedrock sites, such as Valet/Herd drivers, deployment scripts, docs/tutorials, etc.

Directory structure

• Rename web/ directory to public/ to better align with modern PHP practices
• Make the app/ directory (wp-content) the public web root 🔨

Configuration

• Adopt wp-config v2
  • New fluent configuration API
  • Simplified environment handling
• Drop WP_ENV in favor of WordPress core's WP_ENVIRONMENT_TYPE

---

Bedrock v1:

├── composer.json
├── config/
│   ├── application.php     # Primary wp-config
│   └── environments
│       ├── development.php
│       ├── staging.php
│       └── production.php
├── vendor/                 # Composer dependencies
└── web/                    # Public document root
    ├── app/                # WordPress content dir
    │   ├── mu-plugins/
    │   ├── plugins/
    │   ├── themes/
    │   └── uploads/
    ├── index.php
    ├── wp-config.php
    └── wp/                 # WordPress core

Bedrock v2:

├── config.php              # Primary wp-config
├── composer.json
├── vendor/                 # Composer dependencies
└── public/                 # Public document root (renamed from web/)
    ├── index.php
    ├── wp-config.php       # Required wp-config.php from WordPress, loads our wp-config.php from the project root
    ├── mu-plugins/
    ├── plugins/
    ├── themes/
    ├── uploads/
    └── wp/                 # WordPress core

[dalepgrant]

How set are you on the names? Having two files as wp-config.php will get confusing, you're already referring to them as 'primary' and 'required' to differentiate. The one required by WP is obviously going to have to stay as wp-config.php; could the other change to just config.php, or app-config.php? 🤷‍♂

 ├── composer.json
 ├── vendor/                 # Composer dependencies
-├── wp-config.php           # Primary wp-config
+├── config.php              # Consolidated config
 └── public/                 # Public document root (renamed from web/)
     ├── index.php
     ├── wp-config.php       # Required wp-config.php from WordPress, loads our config.php from the project root
     ├── mu-plugins/
     ├── plugins/
     ├── themes/
     ├── uploads/
     └── wp/                 # WordPress core

Edit: make diff clearer

[retlehs]

@dalepgrant Great idea, thank you! 🙏 Just updated the OP