Quick Start（約 5 分）

Phase 15-E のスキャフォールド（homura new）で検証済みの手順です。

前提

• Ruby 3.4+
• Node.js 20+（Wrangler 用）
• mise 等のバージョン管理（推奨）

新規プロジェクト

公開済み gem を使う前提で、そのまま homura new を実行します。

bundle exec homura new myapp
cd myapp
bundle install
npm install

DB 付きサンプルが必要なら --with-db を付けます（sequel-d1 とマイグレーション雛形が追加されます）。

ローカルで動かす

日常操作は Rakefile を入口にします。生成された app では、homura や wrangler は通常 Rake からしか触りません。

bundle exec rake dev
# → bundle exec rake build
# → bundle exec homura build --standalone
# → npx wrangler dev --local --port 8787 --ip 127.0.0.1

別ターミナルで HTTP を確認します。

curl -sS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8787/

応答が 200 であることを確認してください。

デプロイ

bundle exec rake deploy

（Rake 側で build のあと wrangler deploy が走ります。）

現在の制限

• rubygems: opal-homura / homura-runtime / sinatra-homura を基本にし、D1 では sequel-d1、Inertia では sinatra-inertia を追加します。
• ERB: Workers 上では実行時 eval 不可のため、bundle exec homura erb:compile で事前コンパイルが必須。
• Opal: vendor/opal-gem 固定版（Gemfile の path）に合わせる。
• 日常操作: 生成 app では bundle exec rake 系を表の UX にし、homura は Rake の内部実装として扱う。