WordPress theme.json ジェネレーターを作成しました！

WordPress の theme.json とは？

theme.json は、WordPress 5.8 で導入された設定ファイルです。テーマのデザインルールと、Gutenberg ブロックの挙動をまとめて管理できます。たとえば theme.json では、次のような項目を定義できます。

・カラーパレット
・グラデーション
・タイポグラフィ（フォント、サイズ、行間など）
・余白（padding / margin / block gap）
・レイアウト幅（content / wide）

ブロックごとのデフォルトスタイル（ボタンの角丸など）
これにより、テーマ開発者は 機能の有効化・無効化や、サイト全体のデザイン統一をコードベースで行えます。

※一般的に、ブロックテーマでは theme.json は重要な構成要素になります。

ブロック型 WordPress テーマ（ブロックテーマ）とは？

ブロックテーマとは、ブロックエディターとサイトエディター（Gutenberg）での編集を前提に設計されたテーマです。

ブロックテーマには、多くの場合 「パターン（Patterns）」 と呼ばれる、あらかじめ組まれたレイアウト部品が含まれています。
これを挿入するだけで、ページをプロっぽく組み立てやすくなります。

ブロックテーマの主なメリット

・高度なコーディングがなくてもレイアウトを作りやすい
・Elementor などのページビルダーに依存せずデザインできる
・theme.json により、色・余白・文字などの統一ルールを適用しやすい

WordPressのフルサイト編集（FSE）とは？

フルサイト編集（Full Site Editing）は、ブロックエディターを使って、サイト全体の構造やデザインを編集できる機能です。

たとえば以下が編集対象になります。

・ヘッダー / フッター
・サイドバーなどの共通パーツ
・投稿タイプ・固定ページ・タクソノミー別のテンプレート
・サイト全体のスタイル（色、文字、余白など）

FSE は比較的新しい仕組みで、従来の WordPress テーマ制作（PHP テンプレ中心）とはワークフローが大きく異なります。
その分、サイトのデザインとカスタマイズを 直感的に行いやすくなっていく方向で進化しています。

でも theme.json、書くのが大変

WordPress のブロックテーマ開発で避けて通れない存在になってきた theme.json。便利なのは間違いない一方で、「項目が多い」「構造が深い」「ちょっとミスると読まれない」など、はじめて触る人にはなかなか手強いファイルでもあります。
実際に theme.json を手で書こうとすると、だいたいこうなります。

・キーの階層を間違える
・カンマ抜けで全滅する
・styles を複数書いて上書き事故が起きる
・どこに spacingSizes を入れるべきか分からなくなる
・「保存したのに反映されない」→実は JSON が壊れてる
・そんなふうに地味に体力と時間を削られます。

そこで今回、WordPress の theme.json を生成できるジェネレーターを作成しました。
狙いはシンプルで、テーマ制作の初速を上げることです。人類はもうJSONに溺れません。

WordPress theme.json ジェネレーターでできること

今回作成したジェネレーターでは、theme.json の主要項目を 入力 → 出力できるようにしています。

生成項目

• レイアウト幅（content / wide）
• カラーパレットの定義
• フォントファミリーの登録
• フォントサイズ（S/M/L/XLなど）のプリセット
• スペーシング（余白スケール）
• リンクやボタンなどの基本スタイル
• 見出しだけ別フォントにする、などの基本パターン

「動く土台」を数分で作れるので、テーマ制作のスタートがかなり軽くなります！

こんな人におすすめ

• ブロックテーマに取り組み始めたばかりの方
• theme.json を毎回コピペで使い回していて整理したい方
• デザイントークン（色・余白・文字）を統一して運用をラクにしたい方
• 既存テーマを段階的にブロックテーマへ移行している方

WordPress theme.json ファイルの作成方法は？

theme.json は次の位置に配置します。

/wp-content/themes/your-theme/theme.json

あとは必要に応じて CSSやパターンと組み合わせて調整していきます。詳しい設定項目（グローバル設定・スタイルの書き方など）は、WordPress 公式ドキュメントを参照すると確実です。

これから追加したいことと今後の予定

現状は初速を上げる機能に寄せていますが、今後は以下も強化できたらと思っています。

・よくある設計パターン（CTA、FAQ、料金表など）のテンプレ出力
・既存CSSからのトークン抽出（色・余白・文字サイズ）
・ブロックごとのスタイルプリセット拡充
・theme.json のバリデーション（壊れてたら警告）

テーマ制作は、速くなるほど品質が上がります。速いと修正が効くからです。
もし「こういう出力が欲しい」「このブロックも対応してほしい」などあれば、ぜひフィードバックください。
育てれば育つほど、あなたのテーマ制作のスピードも上がります。