個人メディア基盤「homepage」v2.1.1をリリース!CloudFront監視スタックの新設や記事編集UIの改善を実施

皆さん、こんにちは。okamoです。

AIと創る広告ゼロ・都度課金型の個人メディアプラットフォーム「homepage」の最新版 v2.1.1 をリリースしました!

今回のアップデートでは、障害を迅速に検知するための監視スタックの新設や、記事編集画面における画像ドラッグ&ドロップ領域のUI改善、依存ライブラリのセキュリティ脆弱性対応などを行っています。


「homepage」とは?

「homepage」は、外部の広告モデルに依存することなく、読者からの直接課金とAIによる制作支援を組み合わせることで、持続可能な情報発信を実現するオープンソースの個人メディア基盤です。

Next.jsやAWSサーバーレス構成を採用し、高品質な読者体験と低コストな個人運用を両立しています。


v2.1.1 の主なアップデート内容

今回のリリース(ベース: v2.1.0 からの19コミット)における主要なハイライトは以下の通りです。

区分内容
新機能監視スタック新設。CloudFront 5xx 率と Lambda エラーのアラーム+メール通知を追加
改善管理画面の画像アップロードを共通コンポーネント化。記事編集画面でも快適なD&D領域を提供
運用性向上セットアップ画面にインストールする本体バージョン(v2.1.1)を明示
セキュリティzod の High 脆弱性解消(3系 → 4系へ移行)、Dependabot アラート対応

1. 新機能: CloudFront / Lambda 監視・障害通知スタックの新設

これまでの運用の中で、ECRイメージ失効に伴う 502 障害の初動が「利用者からの報告」となってしまった教訓を活かし、オリジン異常を自動検知するアラームスタック(HomepageMonitoringStack / HomepageMonitoringEdgeStack)を追加しました。

Lambda が起動すらしない障害の場合、Lambda 側のエラーメトリクスだけでは検知できません。そのため、CloudFront の 5xx 率を本命の検知手段として設計しています。

  • CloudFront 5xx エラー率アラーム (homepage-cloudfront-5xx-rate): 5%以上が10分継続で発報
  • Lambda エラーアラーム (homepage-app-lambda-errors): 1件以上のエラー(5分間)で発報

アプリケーションスタックと監視スタックを分離することで、監視設定を変更するたびにLambdaイメージの再ビルドが走らない構造に最適化されています。

※ 誤送信防止のため、通知先環境変数 ALARM_EMAIL は初期状態で無効化されています。通知を有効にする際は、セットアップ画面(Step 1b)等から設定し、SNSからの確認メールを承認してください。障害切り分け手順は docs/operations_v2.md をご覧ください。


2. 改善: 記事編集画面の画像アップロードUI刷新

記事編集画面(AIによる記事修正)における画像アップロード機能で発生していた「ドラッグ&ドロップが失敗しやすい」「アップロード領域が小さく操作しづらい」という課題を根本から解消しました。

記事編集画面の画像ドラッグ&ドロップエリア

上記の画面イメージのように、「追加画像(任意・AIが修正時に参照します)」の下に、中央のクラウドアイコンと「画像をドラッグ&ドロップ またはクリックして選択」と明記された、ゆとりのある破線ドロップ領域(min-height 180px)が配置されました。

主な改善点

  • コンポーネント共通化: 記事生成フォームと修正フォームで重複していたアップロード実装を共通化し、200行以上の冗長コードを削除。
  • 操作の堅牢化: ウィンドウ全体で領域外ドロップによる「ブラウザが画像を開いて入力内容が消える事故」を防止。進入カウンタ方式により、子要素をまたいでも枠のハイライトが消えない安定した挙動を実現。
  • 親切なバリデーション: 10MB超のファイルや非画像ファイルをドロップした際、無反応になるのではなく理由付きでエラーを通知。
  • アクセシビリティ向上: キーボード操作(Enter / Space)やタッチ端末での削除操作にも配慮。

これにより、AIに修正指示を出す際の画像添付が格段にスムーズになりました。


3. セットアップ画面のバージョン明示

セットアップ画面(http://localhost:3001)のヘッダーに、これからセットアップする homepage 本体のバージョン(v2.1.1)が表示されるようになりました。

リポジトリ直下の package.json を唯一の情報源とすることで、二重管理を防ぎつつ、ダウンロードしたイメージの判別やサポート時のバージョン確認を容易にしています。


4. セキュリティ強化とパッケージ更新

入力検証ライブラリ zod における高深刻度の脆弱性(GHSA-mrhx-c7xc-m3w5)に対応するため、Zod 3系から 4系(4.6.7)へのメジャーアップデート を実施しました。これに伴い、API Route Handler の入力検証テスト(Vitest 48件)を再確認し、すべて正常にパスしています。

併せて fast-uri の脆弱性解消や、Next.js 16.4.3 へのアップデートなど、セキュアで最新の依存関係を維持しています。


セットアップと導入について

「homepage」は、広告収益モデルの限界を感じているクリエイターやエンジニアが、自立して価値ある情報を届けられる環境を目指して開発されています。

導入手順は以下のドキュメントにわかりやすく整理しています。AWS環境へのデプロイを含め、エンジニア以外の方でも迷わずセットアップできるよう丁寧に解説していますので、ぜひご覧ください。

より安定し、扱いやすくなった homepage v2.1.1 をぜひお試しください!