tmswp / starter-theme

v0.10.0 2026-10-30 13:00 UTC

Requires

• php: >=8.3
• tmswp/core: ^0.10

Requires (Dev)

• brain/monkey: ^2.6
• friendsofphp/php-cs-fixer: ^3.88
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5
• szepeviktor/phpstan-wordpress: ^2.0

GPL-2.0-or-later

Published on Packagist.org on 2026-10-30 13:01 UTC

README

TMStack WordPress Framework を使用したWordPressテーマ。

新規プロジェクトの作成

新規プロジェクトはこの雛形から作成する。作成の直後にbin/setup.phpが、スラッグから名前空間(例: my-shop → MyShop\)を作り、composer.json・tmswp-kernel.php・app/・AGENTS.md・ブロックの名前を書き換えて、自身を削除する。

composer create-project tmswp/starter-theme my-theme

スラッグ(英小文字・数字で、英字で始まり、語を1つの-か_でつなぐ)と表示名は、端末では対話で尋ねる。端末の無い環境(CI等)では、環境変数で渡す。渡さなければエラーで止まる。

TMSWP_SETUP_SLUG=my-theme TMSWP_SETUP_NAME="My Project" composer create-project --no-interaction tmswp/starter-theme my-theme

composer create-project --no-scriptsで作成した場合と、セットアップがエラーで止まった場合は、bin/setup.phpを手で実行し、書き換えた名前空間でオートローダを作り直す(create-projectは、この2つを続けて実行する)。

php bin/setup.php --slug=my-theme --name="My Project"
composer dump-autoload

セットアップの後

WP_DEBUGを有効にしたWordPressのサイト(開発環境)でこのテーマを有効にし、WP-CLIがそのサイトに届く場所で次を実行する。探索結果ファイル(tmswp-discovery.php)を作り、コミットする。探索結果ファイルを作るまでは、WP_DEBUGが無効のサイトでは起動時にエラーになる(debugのときだけapp/を毎回走査する)。

composer install
npm ci
npm run build    # ブロックのビルドと、探索結果ファイルの作成(wp tmswp discover)
composer qa

開発規約

• 開発規約・禁止事項・必須コマンド: AGENTS.md
• タスク別レシピ: vendor/tmswp/core/rules/*.md(どのレシピを読むかはAGENTS.mdの「最初に読むもの」)
• 拡張のレシピ: 拡張を入れるとvendor/tmswp/<拡張>/rules/*.mdに入る