A modern WordPress framework powered by Tempest, featuring attribute-based auto-discovery for hooks, post types, blocks, and more.
Warning
AI-Generated Project — This project was primarily built by AI coding agents (Claude). While functional and tested, it may contain bugs, security issues, or unexpected behavior. Use at your own risk, especially in production environments.
This monorepo contains the following packages:
| Package | Description | Packagist |
|---|---|---|
studiometa/foehn |
Core framework — auto-discovery, DI, blocks, hooks |  |
studiometa/foehn-acf |
ACF integration — blocks, field groups, options pages |  |
studiometa/foehn-installer |
Composer plugin — generates web root, symlinks, wp-config |  |
studiometa/foehn-starter |
Starter theme — the minimum a new project needs |  |
studiometa/foehn-demo |
Demo theme — every feature, and the end-to-end tests |  |
composer create-project studiometa/foehn-starter my-projectcomposer require studiometa/foehn<?php
// functions.php
use Studiometa\Foehn\Kernel;
Kernel::boot(__DIR__ . '/app');- 🚀 Zero configuration — Auto-discovery of components via PHP 8 attributes
- 🎯 Modern DX — Type-safe, IDE-friendly, testable
- 🔌 WordPress native — Works with Timber, ACF, and Gutenberg blocks
- ⚡ Minimal boilerplate — One line to boot your theme
- 📦 Project generator — Full web root generation via Composer plugin
- 🏗️ Starter theme — Complete example with models, hooks, templates
- 🐳 Runtime image —
ghcr.io/studiometa/foehn-wordpress, NGINX and PHP with Føhn's serving rules already installed
| Attribute | Description |
|---|---|
#[AsAction] |
Register a WordPress action hook |
#[AsFilter] |
Register a WordPress filter hook |
#[AsPostType] |
Register a custom post type |
#[AsTaxonomy] |
Register a custom taxonomy |
#[AsBlock] |
Register a native Gutenberg block |
#[AsAcfBlock] |
Register an ACF block |
#[AsBlockPattern] |
Register a block pattern |
#[AsContextProvider] |
Add data to specific views |
#[AsTemplateController] |
Handle template rendering |
#[AsShortcode] |
Register a shortcode |
#[AsRestRoute] |
Register a REST API endpoint |
#[AsCliCommand] |
Register a WP-CLI command |
#[AsTimberModel] |
Register a Timber class map |
#[AsMenu] |
Register a navigation menu |
#[AsImageSize] |
Register a custom image size |
my-project/ # What is VERSIONED
├── theme/ # The WordPress theme
│ ├── app/ # PHP classes (auto-discovered)
│ ├── templates/ # Twig templates
│ ├── functions.php # Single Kernel::boot() call
│ └── style.css # Theme header
├── config/ # Configuration files
├── mu-plugins/ # Custom mu-plugins (if needed)
├── .env # Environment variables
└── composer.json # Dependencies
web/ # GENERATED (100% gitignored)
├── wp/ # WordPress core
├── wp-content/
│ ├── themes/my-theme → symlink to /theme
│ ├── plugins/ # Composer-managed plugins
│ └── mu-plugins/ # Auto-loaded mu-plugins
├── index.php # Generated front controller
└── wp-config.php # Generated from config/
This package includes an Agent Skill at packages/foehn/skills/foehn/SKILL.md with comprehensive usage reference. Compatible agents will discover it automatically.
# Install dependencies
composer install
npm install
# Run tests
composer test
# Lint & fix
composer lint
composer fix
# Format markdown
npm run fmtContributions are welcome! Please read our contributing guidelines before submitting a PR.
MIT License — see LICENSE for details.
- Tempest Framework by Brent Roose
- Timber by Upstatement
- Inspired by Acorn by Roots