まだ間に合う！ 2025年のhono/ssg事情

Hono Conference 2025 でお話しさせていただいた内容です。
https://fortee.jp/honoconf-2025/proposal/03fd0558-0be7-4ac3-ada2-42e4ce6de9f6

Transcript

1. 2025-10-18 #honoconf Hono Conference 2025 まだ間に合う！ 2025年のhono/ssg事情
2. Hono Conference2025…..デカくね めちゃ沢山スポンサー 君の名は…？
3. 自己紹介 Watanabe Yohei(watany) • AWS ◦ AWS Ambassador (2024-) ◦ JAWS-UG Tokyo • Hono(OSS Contributor) ◦ Lambda@Edge Adaptor ◦ Secure Headers Middleware ◦ Timeout Middleware ◦ SSG Helper
4. まだ間に合う? / Missed Nothing Yet?
5. 発案者なのにhono/ssgに追いつけていません https://speakerdeck.com/watany/the-end-of-the-spe cial-time-granted-to-engineers Coding Agent Work 2024: System Development 2025: Migration & Consulting →コードが遠いね… Cloud
6. hono/ssg & Me https://x.com/yusukebe/status/1742850872651206724 2024/01/04 https://github.com/honojs/hono/graphs/contributors?from=2023-12-29&to=2024-02-09&type=c Honoのv4が2月9日にリリースされます https://zenn.dev/yusukebe/articles/b20025ebda310a 2024/02/09
7. Why Hono/SSG? ・何かHonoのHelperを作ってみたかった ・front-end / SSR何もわからん……Staticなコンテンツになっててくれ… ・hono/jsxやhono/cssで書いて、ファイル化できたらいいね ・Remixには公式SSGが無い、Hono公式であったら面白くない？(無謀)
8. 今日の目的 ・Hono/SSGの現在地を理解する ・Hono/SSG Userを増やす ・Hono/SSGにContributeできる人を増やす
9. Remember this! Hono/SSG at 2024/02/09
10. Basic Usage: Manual (1/2) ・いつものHono ・普通にルート設定(GET/ALL) ・c.setRendererとかでルート設定
11. Basic Usage: Manual (2/2)：For Node.js ・Build用のScriptを書く ・Helper(toSSG)に ・arg1：app(=Hono()) ・arg2：fs ・完成！
12. Basic Usage: Manual (2/2)：For Deno & Bun ・Build用のScriptを書く ・toSSG from ‘hono/deno’ or ‘hono/bun’ ・arg1：app(=Hono()) ・arg2：fs ・完成！
13. Basic Usage: Vite Plugin ・@hono/vite-ssgのこれで使える ・(Viteに乗っかるなら)超簡単
14. ワイワイ Middleware (have fun!) ・ssgParams ・静的PathのGenerator(Next.jsのgetStaticPaths 相当) ・今日のKeyNoteの@nakasyouが作った ・disableSSG ・指定ルートをGeneration対象から外す ・onlySSG ・Build以外では404を返す
15. 2024 (v4.0-v4.4)
16. v4.0 - v4.1 v4.0.2: SSG対象のRouteをGET/ALL のみに v4.1.0: ファイル生成の非同期化 その他 fix: 色々不十分でゴメン
17. v4.1 - v4.2 v4.1.3: Async Hook対応 v4.2.0: extentionMap対応
18. v4.3 - v4.4 v4.3.7: Content TypeのDefault= 'text/plain’ v4.4.0: hooksを合体できるやつ v4.4.1: fix Routing(./, ../)
19. DEFAULT_CONTENT_TYPE = 'text/plain' 結構おもろい話なので紹介する ・Bun + Honoで素朴に「return c.text(‘hoge’)」するとContent-Typeが設定さ れない？ issue: #2666 →Hono側でContent-Typeを設定するとBun の時に遅いから何もつけてない by @yusukebe →遅いならダメかあ…(このDefaultへ)
20. HonoX
21. hono/ssg ＋ HonoX ・Hono/SSG：watanyが提案した静的ファイル化するヘルパー ・HonoX：@yusukebeがコッソリ作ってたHono前提のフロントエンドFW → どっちもHonoだし、くっつければ何とかなるやろ！
22. ＼ ダメだった ／ @hono/vite-ssgとhonox/vite/clientを同時に使うと、先に作ったファイルが飛ぶ ※今では直っています ※他のダメだったとこも直っています
23. 2025 (v4.7-)
24. v4.7 - v4.9 v4.7.: fix: Extension Map v4.8.0: SSG Plugin System v4.9.0: All 3 hooks deprecated.(v5)
25. この資料作成のために調べたら SSG Hookが非推奨予定に なっててワロタ (正しい方向性だと思う)
26. という訳で hono/ssg Hook to Plugin を理解する
27. 3行で分かるhono/ssg 1. Honoって普通にローカルでテストできる 2. = localhost叩けば結果を取れる 3. = 全ルートのレスポンスを出力すればSSG (こんな発想だけでミドルウェアを作ると大変なことになります)
28. Hook • 前提： ◦ hono/ssgはファイル対象のルートをフィルタする() ◦ filterStaticGenerateRoutes: GET/ALLのみ。ミドルウェアは捨てる ◦ ファイル化前後に自然体に処理が入らない。 • だからHookが必要。
29. Hookのつらいとこ • Hookは3種類ある ◦ リクエスト前：BeforeRequestHook ◦ レスポンス後：AfterResponseHook ◦ ファイル化後：AfterGenerateHook
30. Hookのつらいとこ
31. こういうのがいいよね
32. Hooks → Plugin
33. Plugin
34. ※defaultPlugin
35. わかるけど、フレームワークなんだから Plugin用意しといてくれよ
36. @hono/ssg-plugins-essential
37. SSG-Essential-Plugin SSGに不可欠(Essential)なプラグイン。 • 2025/10/18時点で以下がある。 ◦ ・Sitemap ◦ ・robots.txt ◦ ・RSS/Atom
38. SSG-Essensial-Plugin：Sitemap
39. SSG-Essensial-Plugin：robots.txt
40. SSG-Essensial-Plugin：RSS/Atom
41. Pluginいいよね！ ありがとう@3w36zj6 (Plugin諸々の作者)
42. まとめ • hono/ssg、基本的なとこは動く ◦ 軽い速い。個人サイトとかに使ってくれてる人もいる ◦ S3/R2に置けるものとかに、ガンガン使ってほしい • 足りない機能は沢山ある、Contributor求む！ ◦ 私がやるべき…はい…… ◦ hono/ssg, @hono/vite-ssg, @hono/ssg-plugins-essential ◦ 欲しいEssential Pluginを足してくのがおすすめ