← Blog
TanStack StartCloudflareViteDeploy

TanStack Start × Cloudflare Pages — 詰まった全記録と解決策

18 分で読める

このトピックを深掘りする

TanStack Start × Cloudflare

TanStack StartとCloudflare Pagesを組み合わせたフルスタック構成・Tailwind v4移行

全4本中 2 本目。

このトピックの記事一覧

シリーズ全体の流れを見ながら、次に読む記事へ進めます。 初めての方は /start →

よくある質問

Q. TanStack StartとCloudflare Pagesの組み合わせで最初に注意すべき点は何ですか?
Viteプラグインの登録順序が最重要。cloudflareプラグインをtanstackStartより前に配置しないと「server-entry not found」エラーになる。
Q. TanStack StartのServerFnはCloudflare Pagesで使えますか?
2026年2月時点ではSSR環境で正しく動作しない既知のバグがある。回避策として、全データをsrc/data/に静的TypeScript定数として配置する設計が有効。
Q. SSRでダークモードのFOUC(白フラッシュ)を防ぐにはどうすればよいですか?
head内にインラインスクリプトを配置し、ハイドレーション前にlocalStorageからテーマを読み取ってHTMLクラスを適用する。html要素にsuppressHydrationWarningを付与して警告を抑制する。