Create-hono

create-hono がサポートするコマンドラインオプションを紹介します。これは npm create hono@latest、npx create-hono@latest、pnpm create hono@latest を実行したときに動作するプロジェクト初期化ツールです。

NOTE

このページの目的 インストールやクイックスタートの例では、最小限の npm create hono@latest my-app コマンドがよく示されます。create-hono は、テンプレートの選択、プロンプトの省略、パッケージマネージャーの選択、ローカルキャッシュの利用など、プロジェクト作成を自動化しカスタマイズする便利なフラグをサポートしています。

引数の渡し方：

npm create（または npx）を使う場合、初期化スクリプトに渡す引数は -- の後に指定する必要があります。-- の後にある内容はすべて初期化ツールに転送されます。

npm

# Forwarding arguments to create-hono (npm requires `--`)
npm create hono@latest my-app -- --template cloudflare-workers

yarn

# "--template cloudflare-workers" selects the Cloudflare Workers template
yarn create hono my-app --template cloudflare-workers

pnpm

# "--template cloudflare-workers" selects the Cloudflare Workers template
pnpm create hono@latest my-app --template cloudflare-workers

bun

# "--template cloudflare-workers" selects the Cloudflare Workers template
bun create hono@latest my-app --template cloudflare-workers

deno

# "--template cloudflare-workers" selects the Cloudflare Workers template
deno init --npm hono@latest my-app --template cloudflare-workers

よく使う引数

引数	説明	例
--template <template>	スターターテンプレートを選択し、対話形式のテンプレート選択を省略します。bun、cloudflare-workers、vercel などのテンプレートがあります。	--template cloudflare-workers
--install	テンプレートの作成後、自動的に依存関係をインストールします。	--install
--pm <packageManager>	依存関係をインストールするパッケージマネージャーを指定します。一般的な値は npm、pnpm、yarn です。	--pm pnpm
--offline	最新のリモートテンプレートを取得せず、ローカルのキャッシュやテンプレートを使います。オフライン環境や再現性を求めるローカル実行に便利です。	--offline

NOTE

正確なテンプレートと利用可能なオプションは、create-hono プロジェクトが管理しています。このページはよく使うフラグの概要です。完全な公式情報は、下記のリポジトリを参照してください。

実行例

最小限の対話形式

npm create hono@latest my-app

テンプレートとオプションを選択するよう求められます。

非対話形式でテンプレートとパッケージマネージャーを選ぶ

npm create hono@latest my-app -- --template vercel --pm npm --install

vercel テンプレートで my-app を作成し、npm で依存関係をインストールして、対話形式のプロンプトを省略します。

オフラインキャッシュの利用（ネットワーク不要）

pnpm create hono@latest my-app --template deno --offline

トラブルシューティングとヒント

• オプションが認識されない場合は、npm create / npx を使う際に -- で転送していることを確認してください。
• 最新のテンプレートとフラグの一覧は、create-hono リポジトリを確認するか、初期化ツールをローカルで実行してヘルプ出力を参照してください。

リンクと参考資料

• create-hono リポジトリ：create-hono