ノービルド宣言:バンドラーなしで本番に出す

以下は、ビルドツールを捨てるべきだという主張ではありません。捨てたときに何が起こるかの計測結果です。

blakecrosley.comはFastAPI + Jinja2 + HTMX + Alpine.js + プレーンCSSで動いています。webpackなし。Viteなし。Rollupなし。TypeScriptコンパイラなし。Babelなし。PostCSSなし。Tailwindなし。package.jsonなし。node_modules/なし。このサイトは37本のブログ記事(インタラクティブなJavaScriptコンポーネント20個を含む)、20本のガイド、10言語の翻訳を配信し、Lighthouseスコアは100/100/100/100です。Lighthouseスコアはご自身で確かめられます。任意のページでPageSpeed Insightsを実行してみてください。11

TL;DR

HTMXコミュニティには支持の声がたくさんあります。不足しているのはエビデンスです。ここに示す数値は、充実したコンテンツ、インタラクティブ機能、多言語対応を備えた本番サイトから得たもので、ビルドツールは一切使っていません。トレードオフは正直に示しており、結論は限定的です。コンテンツ中心のサイトをソロ開発者や少人数チームで運営する場合、ビルドツールは抱えてもいない問題を解決し、抱えることになる問題を生み出します。共有コンポーネントライブラリやデザインシステムパッケージを持つ大規模チームでは、ビルドツールはその複雑さに見合う価値があります。境界線は、議論が示唆するよりも明確です。


スタック構成

Backend:    FastAPI + Jinja2 (server-rendered HTML)
Frontend:   HTMX + Alpine.js + Bootstrap 5 (CDN)
Styles:     Plain CSS with custom properties
JavaScript: Vanilla JS, IIFE-scoped per component
Deployment: Railway (git push → live)
CDN:        Cloudflare (caching, Workers, D1)

トランスパイルなし。ツリーシェイキングなし。ホットモジュールリプレースメントなし。ソースマップなし。書いたJavaScriptがそのまま配信されるJavaScriptです。


実際の数値

推定値ではなく、実測値を示します。

指標 blakecrosley.com 一般的なNext.jsプロジェクト(著者の推定)1
依存パッケージ数 Pythonパッケージ15個 npmパッケージ311個(検証済み:npx create-next-app@latest、2026年2月)1
ビルド設定ファイル 0 5〜8(next.config、tsconfig、postcss、tailwind、eslint、babelなど)
node_modules/のサイズ 存在しない ベースライン187 MB(検証済み)、追加後は250〜400 MB1
インストール時間 pip install -r requirements.txt:8秒 npm install:30〜90秒
ビルドステップ なし next build:15〜60秒
デプロイパイプライン git push → 約40秒で本番反映 git push → インストール → ビルド → デプロイ:2〜5分
CSSファイル 17ファイル、10,846行(プレーンCSS) Tailwind/Sassから生成、出力は様々
JSファイル 33ファイル、8,819行(人間が読める形式) バンドル・圧縮・チャンク分割済み:本番環境では読めない
Lighthouseパフォーマンス 100 明示的な最適化なしでは70〜90(Vercel自身のパフォーマンスドキュメントによる)13

15個のPythonパッケージにはFastAPI、Jinja2、Pydantic、その他12個が含まれます。ビルドツールは1つもありません。コンパイラもありません。バンドラーもありません。2


失うもの

正直であるためには、実際のコストを列挙する必要があります。コストは確かに存在します。

TypeScriptがない。 このプロジェクトのすべての.jsファイルはバニラJavaScriptです。型エラーはコンパイラではなく、テストとClaude Codeの解析で捕捉します。ソロ開発者には有効なアプローチです。10人のチームがモジュール間でコンポーネントインターフェースを共有するなら、このやり方は通用しないでしょう。

ホットモジュールリプレースメントがない。 CSSファイルを変更したら、ブラウザを手動でリロードします。HTMXのhx-boostはAJAXでbodyの内容だけを取得し、ページ全体を読み込み直さずに差し替えるため、ナビゲーションが十分に速く、フルリロードでも苦になりません。30秒ごとにビジュアルの細部を調整するようなプロジェクトなら、HMRで意味のある時間を節約できるはずです。

ツリーシェイキングがない。 書いたJavaScriptは1バイト残らずブラウザに配信されます。ユーティリティライブラリから関数を1つだけインポートすることはできず、ファイル全体を配信することになります。ツリーシェイキング(バンドラーがインポートの経路をたどり、どのモジュールからも参照されない関数を取り除くデッドコード除去)は、定義上ビルドステップを必要とします。この制約が規律を強います。大きなユーティリティモジュールではなく、小さく焦点を絞ったファイルを書くことになるのです。20個のインタラクティブコンポーネントは、自己完結している必要があるため、平均してそれぞれ130〜450行です。3

npmのコンポーネントライブラリが使えない。 Radixもshadcn/uiもHeadless UIもありません。すべてのインタラクティブ要素(ボイドシミュレーション、ハミングコードビジュアライザー、合意形成シミュレーター)は手作りです。このアプローチが成立するのは、インタラクティブコンポーネントが汎用的なUIパターンではなく、特定の教育目的に特化しているからです。

npmのデザインシステムトークンが使えない。 私のデザインシステムはすべてCSSカスタムプロパティで構築されています。他のプロジェクトにパッケージとしてインポートすることはできません。単一サイトのシステムなら許容範囲です。複数のプロダクトを抱える組織では、そうはいきません。

この5つのトレードオフは、1人の開発者が運営するコンテンツ中心のサイトなら許容できます。15人のエンジニアリングチームが開発するSaaSプロダクトでは許容できないでしょう。


得られるもの

ビルド失敗がゼロ。 デプロイパイプラインはgit pushだけです。ピア依存関係の競合でnpm installが失敗することはありません。触ってもいないファイルのTypeScriptエラーでnext buildが失敗することもありません。Dependabotのプルリクエストが推移的依存関係をアップグレードしてビルドを壊すこともありません。4

View Sourceでデバッグできる。 ブラウザで実行されるJavaScriptは、私が書いたJavaScriptそのものです。ソースマップは不要です。コンパイル出力から元のソースへの対応付けも要りません。本番環境でバグが出たら、デプロイされたファイルを直接読めば済みます。

ローカル起動が一瞬。 uvicorn app.main:app --reloadは2秒以内に起動します。ページを表示する前にインストール、コンパイル、バンドルを行うnpm run devはありません。

リクエストの流れが具体的。 ブログ記事への初回訪問で読み込まれるのは、HTMLドキュメント1つ(gzip圧縮で約15KB)、CSSファイル1つ(約8KB)、ページ固有のCSSファイル1つ(約2KB)、CDNからのHTMX(約14KB、キャッシュ済み)、CDNからのAlpine.js(約14KB、キャッシュ済み)、そしてそのページのインタラクティブJSコンポーネント(約4〜8KB)です。転送量の合計は初回訪問で45〜60KB、キャッシュ後は15〜25KBです。バンドル分割もチャンクのネゴシエーションも、ランタイムでのモジュール解決もありません。ブラウザはページに必要なものだけを、過不足なくリクエストします。

Dependabotのノイズがゼロ。 package-lock.jsonがないので、semver、ansi-regex、glob-parentのように、直接インポートしたこともないのに依存ツリーの3階層下に潜んでいるパッケージを更新する週次のプルリクエストも来ません。

フロントエンドが将来にわたって動く。 クライアント側のコードは10年後も動きます。HTMLはHTML。CSSはCSS。JavaScriptはJavaScript。Webpack 4 → 5への移行も、Create React Appの非推奨化も、Next.jsのApp Routerへの移行もありません。プラットフォームそのものが標準です。5 ただしサーバー側の依存関係(FastAPI、Python、Railway)には、今もバージョン管理と時折の更新が必要です。ノービルドのアプローチがなくすのはフロントエンドのツールチェーンの入れ替わりであって、バックエンドの保守ではありません。


アーキテクチャとしてのHTMX

HTMXをめぐる議論は、hx-get、hx-swap、hx-targetといった構文に集中しがちです。それは捉え方を間違えています。アーキテクチャ上の洞察は、サーバーレンダリングされたHTMLこそがAPIであるという点にあります。

従来のSPAの場合:

Browser → fetch('/api/users') → JSON → React renders HTML → DOM update

HTMXの場合:

Browser → GET /users (hx-get) → Server renders HTML fragment → DOM swap

サーバーが最終的な表現をそのまま返します。クライアント側の状態管理も、シリアライズ/デシリアライズも、ハイドレーションもありません。Jinja2テンプレートがそのままコンポーネントです。FastAPIのエンドポイントがそのままAPIです。3層ではなく、1層です。6

アーキテクチャ上の影響は連鎖します。3つの排除があり、それぞれが個々のバグではなく、問題のカテゴリーそのものを取り除きます。

JSONの境界がない。 レスポンスの形の不一致、nullとundefinedの曖昧さ、日付のシリアライズの食い違いが消えます。TypeScriptやZodは、こうしたバグを防ぐために存在します。HTMXはJSONではなくHTMLを返すことで、このカテゴリーごと排除します。

クライアント側の状態管理がない。 サーバーの状態とクライアントの状態を一致させ続けることは、SPA開発でもっとも難しい部分です。HTMXは信頼できる情報源をサーバーただ1つにすることで、この問題を取り除きます。

ハイドレーションがない。 ページがサーバーのHTMLを描画した後、JavaScriptフレームワークがクライアント側で再描画してちらつく「不気味の谷」は存在しません。サーバーのHTMLが最終出力です。

具体的に比べると違いがよくわかります。入力に合わせて検索するインプットを、2通りの方法で作ってみます。

React + ビルドツールの場合(JSX、トランスパイルが必要):

// SearchBox.jsx — requires Babel, bundler, npm install
import { useState, useEffect } from 'react';
export default function SearchBox() {
  const [query, setQuery] = useState('');
  const [results, setResults] = useState([]);
  useEffect(() => {
    if (!query) return setResults([]);
    fetch(`/api/search?q=${query}`).then(r => r.json()).then(setResults);
  }, [query]);
  return (<div>
    <input value={query} onChange={e => setQuery(e.target.value)} />
    <ul>{results.map(r => <li key={r.id}>{r.title}</li>)}</ul>
  </div>);
}

HTMX + サーバーレンダリングの場合(プレーンなHTML、ビルドステップなし):

<!-- search.html — ships as-is, no transpilation -->
<input type="search" name="q"
       hx-get="/search" hx-trigger="keyup changed delay:300ms"
       hx-target="#results" />
<ul id="results"></ul>
# server — returns rendered HTML, not JSON
@router.get("/search")
async def search(q: str = ""):
    results = await db.search(q)
    return templates.TemplateResponse("partials/results.html",
        {"results": results})

HTMX版には、クライアントの状態も、シリアライズの境界も、ビルドステップもありません。サーバーが最終的なHTMLを返し、ブラウザがそれを差し込みます。やり取り全体は、テンプレート8行とPython 5行で完結します。

このパターンは複利的エンジニアリングの原則にそのまま対応しています。インフラの各要素がちょうど1つのことだけを行い、互いに干渉せずに組み合わさります。テンプレートはHTMLをレンダリングし、ルートがそれを返し、HTMXがそれを差し込みます。これらの要素を調整するビルドステップは存在しません。調整が必要ないからです。

より複雑な例:バリデーション付きのマルチステップフォーム

入力に合わせた検索は、HTMXの定番デモです。マルチステップフォームなら、このパターンを本番レベルの複雑さで示せます。サーバー側のバリデーション、条件付きのステップ遷移、そしてクライアント側の状態管理なしにリクエストをまたいで保持される状態です。

<!-- step1.html — first form step -->
<form id="signup-form" hx-post="/signup/step1" hx-target="#signup-form" hx-swap="outerHTML">
  <input type="email" name="email" required />
  <button type="submit">Next</button>
</form>
# server — validates step 1, returns step 2 or errors
@router.post("/signup/step1")
async def signup_step1(request: Request, email: str = Form(...)):
    if not validate_email(email):
        return templates.TemplateResponse("partials/step1.html",
            {"error": "Invalid email format", "email": email})
    # Store progress server-side (session, DB, or signed cookie)
    request.session["signup_email"] = email
    return templates.TemplateResponse("partials/step2.html",
        {"email": email})
<!-- step2.html — second step, rendered by server only after step 1 validates -->
<form id="signup-form" hx-post="/signup/step2" hx-target="#signup-form" hx-swap="outerHTML">
  <p>Email: {{ email }}</p>
  <input type="text" name="name" required />
  <input type="password" name="password" minlength="8" required />
  <button type="submit">Create Account</button>
</form>

フォームの状態はサーバーが持ちます。ステップ2は、ステップ1がサーバー側でバリデーションを通過した後にしか描画されません。クライアント側の条件付きレンダリングも、フォーム状態のライブラリも、useReducerも不要です。バリデーションエラーが出れば、現在のステップがエラーメッセージ付きの同じステップに置き換わります。マルチステップのフロー全体で、クライアント側のJavaScriptはゼロです。Reactで同じフローを作るなら、フィールドごとのuseState、ステップのカウンター、条件付きレンダリングのロジック、クライアント側のバリデーション(サーバー側のバリデーションの重複)、そしてAPIのシリアライズ境界が必要になります。HTMX版は、バリデーションのロジックがすでにある場所、つまりサーバーに状態を置くことで、この5つの懸念をすべてなくします。


プレーンCSSで十分

私のデザインシステムは、10個のカラートークン、13段階のタイプスケール、8つのスペーシング値を使っています。すべてCSSカスタムプロパティです。

:root {
  --color-bg-dark:        #000000;
  --color-text-primary:   #ffffff;
  --color-text-secondary: rgba(255,255,255,0.65);
  --spacing-sm:           1rem;
  --spacing-md:           1.5rem;
  --font-size-lg:         1.25rem;
}

Sassのコンパイルステップなし。ユーティリティを生成するTailwindの設定なし。独自構文を変換するPostCSSプラグインなし。ブラウザがこれらの値を直接読み取ります。CSSカスタムプロパティには、プリプロセッサの変数にはない能力があります。DOMをカスケードし、親要素から継承し、メディアクエリで上書きしたり、実行時にコンポーネント単位でスコープしたりできます。Sassの変数は静的な値にコンパイルされて消えてしまいます。カスタムプロパティは生きたまま残るので、テーマの切り替えやダークモードのトグル1つで、派生するすべての値が再コンパイルなしに変わります。7

このサイトの美とブルータリズムの美学(真っ黒の上に白、4段階の不透明度)は、制約から生まれました。カラーパレットに頼れないとき、タイポグラフィが階層を担います。コンポーネントの影に頼れないとき、余白が構造を作ります。制約そのものがデザインなのです。8


CLSとの格闘

Lighthouseへの道のりは、ノービルドの本当のコストを1つ浮き彫りにしました。クリティカルCSSの抽出に、自作のPythonスクリプトが必要だったのです。Next.jsのプロジェクトなら、フレームワークがこれを自動で処理します。

具体的なバグはこうです。モバイル用のメディアクエリがCSSカスタムプロパティを上書きしていました(--gutter: 48px → --gutter: 24px)。クリティカルCSSにはデスクトップの値が含まれていましたが、モバイルの上書きは含まれていませんでした。そのためモバイルでは、ヒーロー部分がまず48pxのパディングで描画され、フルのスタイルシートが読み込まれた時点で24pxにずれ、CLSが0.493になっていました。

修正は、メディアクエリによる上書きも含めてクリティカルCSSを抽出する12行のPythonでした。

# critical_css.py — extract CSS rules matching critical selectors
# including @media overrides for mobile-first responsive values
import re

def extract_critical(css_text, selectors):
    rules = []
    for sel in selectors:
        # Match both direct rules and media-wrapped rules
        pattern = rf'{re.escape(sel)}\s*\{{[^}}]+\}}'
        rules.extend(re.findall(pattern, css_text))
    # Also extract @media blocks containing critical selectors
    media_blocks = re.findall(r'@media[^{]+\{([^}]+\{[^}]+\}[\s]*)+\}', css_text)
    for block in media_blocks:
        if any(sel in block for sel in selectors):
            rules.append(block)
    return '\n'.join(rules)

調査には3時間かかりました。修正そのものは20分です。ビルドツールがあれば自動で処理されていたでしょう。

正直に損得を計算すると、こうなります。ビルドツールは手作業でできることを自動化してくれますが、手作業版は壊れたときにデバッグの時間というコストがかかります。問題は、自動化のコスト(複雑さ、依存関係、ビルドの失敗、移行に伴う入れ替わり)が、手作業のコスト(時折のデバッグ作業)を上回るかどうかです。

このサイトでは、手作業のコストの方が低く済んでいます。3年間で、CLSのバグが1件、デバッグが3時間。10 代わりにビルドパイプラインを保守していたら、依存関係の更新、破壊的変更、設定のメンテナンスに、累計でもっと多くの時間を費やしていたはずです。


このアプローチが適さないケース

ノービルドのアプローチは、次のような場合には適していません。

大規模なチーム。 TypeScriptの価値はチームの規模とともに大きくなります。9 10人の開発者がコンポーネントのインターフェースを共有するとき、コンパイル時の型チェックは、ランタイムのテストでは見つかるのが遅すぎる統合バグを防いでくれます。ソロ開発者はシステム全体を頭の中に収めておけます。チームにはそれができません。

デザインシステムのパッケージ。 複数のプロダクトがデザインシステムを利用するなら、適切なバージョニング、ツリーシェイキング、ビルドパイプラインを備えたnpmパッケージである必要があります。1枚のスタイルシートに書かれたCSSカスタムプロパティは、リポジトリをまたいで組み合わせることができません。

複雑なクライアント状態。 アプリケーションがリッチなクライアント側の状態(ドラッグ&ドロップのインターフェース、リアルタイムの共同編集、オフラインファーストのデータ)を持つなら、ReactやSvelteのようなフレームワークはその複雑さに見合う価値があります。HTMXはクライアントの状態をサーバーとの往復に置き換えます。この方式は、レイテンシが問題になるまでは機能します。

npmエコシステムのライブラリ。 Radixのプリミティブ、Framer Motion、TanStack Queryが必要なら、ビルドパイプラインが必要です。3つともバンドラーの存在を前提にしています。バンドラーなしで使うのは、苦痛から不可能までのどこかになります。

境界線は、議論が示唆するよりも単純です。アプリケーションが主にサーバーで描画されるコンテンツなら、ビルドツールはオーバーヘッドです。アプリケーションが主にクライアントで管理される状態なら、ビルドツールはインフラです。

判断基準:ビルドツールは必要か

次の4つの質問に答えてください。

  1. 5人を超える開発者がJavaScriptのインターフェースを共有していますか? 答えが「はい」なら、TypeScriptのコンパイル時の型チェックが、ランタイムのテストでは見つかるのが遅すぎる統合バグを防いでくれます。ビルドステップを追加しましょう。

  2. アプリケーションは複雑なクライアント側の状態を管理していますか? ドラッグ&ドロップ、リアルタイムの共同編集、オフラインファーストのデータが(あれば嬉しい機能ではなく)中核の機能なら、ReactやSvelteのようなフレームワークはその複雑さに見合う価値があります。ビルドステップを追加しましょう。

  3. 複数のプロダクトが共有のコンポーネントライブラリを利用していますか? 答えが「はい」なら、そのライブラリにはnpmパッケージ化、セマンティックバージョニング、ツリーシェイキングが必要です。ビルドステップを追加しましょう。

  4. バンドラーを前提とするnpmエコシステムのライブラリに依存していますか? Radix、Framer Motion、TanStack Queryなどのライブラリがプロダクトの中核にあるなら、ビルドパイプラインは欠かせません。

4つの答えがすべて「いいえ」なら、ノービルドのアプローチは成り立ちます。1つでも「はい」があれば、ビルドツールは実際に抱えている問題を解決してくれます。間違いは、4つの答えがすべて「いいえ」なのにビルドツールを加えることです。それは抱えてもいない問題を解決しながら、依存関係の管理という実際の負担を生み出すことになります。

演習:いまのプロジェクトを監査してみましょう。 du -sh node_modules/(またはそれに相当するコマンド)とwc -l package-lock.jsonを実行し、2つの数値を書き留めてください。次に、ビルドパイプラインの機能のうち、(開発者体験ではなく)ユーザーに直接役立っているものを3つ挙げてください。3つ挙げられないなら、そのパイプラインはプロダクトよりもツールチェーンのために働いているのかもしれません。数値そのものが悪いわけではありません。それは複雑さの計測値であり、複雑さは自らの存在価値を示すべきものです。


重要なポイント

ソロ開発者と少人数チームへ:

  • 証明は議論ではなく、サイトそのものです。 blakecrosley.comは37本の記事、20個のインタラクティブコンポーネント、20本のガイド、10言語を、ビルドツールゼロ、Lighthouseスコア満点で配信しています。数値は検証できます。

  • ノービルドの正直なコストは、時折のデバッグです。 CLSのバグの修正には3時間かかりました。ビルドツールなら自動で処理していたでしょう。3年間で費やしたデバッグ時間の累計は、ビルドパイプラインの保守に必要だったはずの累計時間よりもはるかに少なく済んでいます。

  • 制約がデザインを生みます。 色を使わないことで、タイポグラフィが階層を担うようになりました。ビルドツールを使わないことで、シンプルで自己完結したJavaScriptが生まれました。最良の制約とは、必要になる前に自ら選んだ制約です。

技術スタックを選定するチームリーダーへ:

  • ビルドツールはチーム規模の問題を解決します。 TypeScript、ツリーシェイキング、コンポーネントライブラリは、複数の開発者がインターフェースを共有するときに、その複雑さに見合う価値を発揮します。コンテンツ中心のサイトを作るソロ開発者は、こうした問題を抱えていません。

  • HTMXの本当の貢献はアーキテクチャにあります。 サーバーレンダリングされたHTMLをAPIとすることで、クライアントの状態管理、シリアライズ、ハイドレーションが不要になります。構文は、この洞察に比べれば二次的なものです。


よくある質問

HTMXは実際のWebアプリケーションの本番環境で使えますか?

使えます。HTMXは2020年から安定しており、さまざまな業界の企業が本番環境で使っています。作者のCarson Grossは後方互換性を設計の中核原則として維持しており、HTMXのドキュメントは「htmxはセマンティックバージョニングに従い、メジャーバージョンの範囲内で既存のアプリケーションを壊すことはない」と明言しています。14 ライブラリ本体はminifyとgzip圧縮で14KB、依存関係はゼロで、セマンティックバージョニングに従っています。blakecrosley.comは3年間HTMXを本番で運用してきましたが、HTMXに起因するバグはゼロです。遭遇した問題はすべて、ライブラリではなくアプリケーションのロジックにありました。

ビルドステップなしでTypeScriptは使えますか?

部分的には使えます。TypeScriptのファイルはtsc --noEmitで出力ファイルを生成せずに型チェックできるので、トランスパイラではなくリンターとして、コンパイル時の型チェックを得られます。ただし、ブラウザは.tsファイルを直接実行できないため、TypeScriptをブラウザに配信するにはやはりビルドステップが必要です。代わりの方法は、プレーンな.jsファイルにJSDocの型注釈を書くことです。TypeScriptはこれをコンパイルなしでチェックできます。開発中は型安全性を得ながら、配信するのは標準のJavaScriptのまま、という形になります。

このアプローチはAstroや11tyと比べてどうですか?

Astroと11tyは中間に位置します。どちらもクライアント側のJavaScriptを最小限またはゼロにしたプレーンなHTMLを生成する静的サイトジェネレーターですが、ビルドステップ(Node.js、npm install、ビルドコマンド)はやはり必要です。ノービルドのアプローチは、そのビルドステップを完全になくします。サーバーがリクエストのたびにHTMLを描画するからです。トレードオフはこうです。Astroと11tyはより高速な静的ページを生成します(サーバー側の計算がないため)。一方、FastAPI + HTMXは動的なコンテンツ(ユーザー固有のデータ、フォームの送信、リアルタイムの更新)を、APIレイヤーなしでネイティブに扱えます。

Web開発チームはビルドツールやnpmなしで出荷できますか?

チームが何を作っているかによります。コンテンツ中心のサイトや社内ツールなら、2〜5人のチームがサーバーレンダリングのHTMLとプレーンCSSで、ビルドツールなしに出荷に成功しています。最初に効いてくる制約は、共有するコンポーネントのインターフェースです。TypeScriptがないと、2人の開発者がある関数の期待する入力について食い違っていても、コンパイラはそれを捕まえてくれません。実際の境界は、共有のJavaScriptに取り組む開発者が5〜8人程度のあたりです。それを超えると、TypeScriptとコンポーネントライブラリはその複雑さに見合う価値を持ちます。


JavaScriptの依存関係のコストは、この著者だけが観察したものではありません。Potvin, R.とLevenberg, J.(2016年)の「Why Google Stores Billions of Lines of Code in a Single Repository」は、大規模な依存関係管理が組織にもたらすコストを記録しています。12 個々のプロジェクトのレベルでは、npmエコシステムの依存関係の深さが、ここで述べたとおりの保守の負担を生みます。開発者が選んだわけではない推移的依存関係が、開発者の対処すべき更新圧力を生み出すのです。

この記事は、ブログのデザインセクションとエンジニアリングセクションの橋渡しとなります。デザイン上の判断は美とブルータリズム、スタートアップのためのデザインシステム、タイプスケールで取り上げています。エンジニアリングの計測値はLighthouse満点への道と複利的エンジニアリングにあります。バイブコーディングの記事では、この哲学がAI支援開発のどこに当てはまるのかを探っています。



  1. 「一般的なNext.jsプロジェクト」の列は、著者が2021年から2024年にかけて5つ以上のNext.jsプロジェクトで得た経験と、コミュニティで報告されている標準的な数値を反映しています。参考までに、新規のnpx create-next-app@latest(Next.js 15、2026年2月にテスト)はnode_modules/に311個のパッケージをインストールし、合計187 MBになります。表の311パッケージと187 MBがこの実測ベースラインです。依存関係を追加した本番プロジェクトではさらに大きくなる傾向があり、表の250〜400 MBという幅はそこから来ています。個々のプロジェクトによって大きく異なります。 ↩↩↩

  2. 2026年2月時点の完全な依存パッケージ一覧:fastapi、uvicorn、starlette、pydantic、pydantic-settings、jinja2、markdown、pygments、beautifulsoup4、lxml、nh3、resend、python-multipart、httpx、analytics-941。ビルドツールはゼロ。コンパイラもゼロ。バンドラーもゼロです。 ↩

  3. コンポーネントの平均サイズ(130〜450行)は、2026年2月時点の/static/js/にある20個のインタラクティブなJSファイルから計測しました。サイズは132行(compound-interest-mind.js)から450行(subtraction-machine.js)の範囲で、1,666行のarcade.jsは外れ値です。 ↩

  4. 著者がNext.jsプロジェクトを保守してきた経験では、JavaScriptエコシステムはアクティブなプロジェクトに対して月に15〜25件のDependabotのプルリクエストを生成し、そのほとんどは開発者が直接インポートしたことのない推移的依存関係の更新です。この数値は直接の観察に基づく推定であり、独立して検証されたベンチマークではありません。 ↩

  5. Webプラットフォーム(HTML、CSS、JavaScript)は30年にわたって後方互換性を維持してきました。1996年のページは2026年のChromeでも表示されます。Tim Berners-Leeはこれを設計原則として次のように述べています:”a browser should be backwards-compatible, in that it should be able to read an earlier version of the language.” w3.org/DesignIssues/Principlesを参照してください。 ↩

  6. HTMXの作者Carson Grossは、これを「hypermedia as the engine of application state」(HATEOAS)と表現しています。htmx.orgのエッセイと、Gross、Stepinski、Cotterによる書籍『Hypermedia Systems』(2023年)を参照してください:hypermedia.systems。 ↩

  7. CSSカスタムプロパティ(CSS変数)は、世界のブラウザの97%以上でサポートされています。出典:caniuse.com/css-variables。使用にコンパイルステップは不要です。 ↩

  8. 「デザインの道具としての制約」という原則には長い歴史があります。Charles Eamesの言葉:”Design depends largely on constraints.” 映画におけるドグマ95運動は、道具を取り除くこと(人工照明なし、ポストプロダクションなし)が、ストーリーテリングを貧しくするのではなく、より誠実にすることを証明しました。en.wikipedia.org/wiki/Dogme_95を参照してください。 ↩

  9. 2024年のStack Overflow Developer Surveyでは、TypeScriptはもっとも使われているプログラミング言語の上位5つに入り、JavaScriptのスーパーセットとしてはもっとも広く採用されています。調査の方法論と全結果はsurvey.stackoverflow.co/2024/にあります。TypeScriptの採用がチームの規模と相関するという見方は、業界の慣行から著者が推論したものであり、調査の直接の結果ではありません。 ↩

  10. このサイトのgit履歴は2023年3月に始まります。「3年間」という数値は、Railwayへの最初のデプロイ(2023年3月)から2026年2月までの期間を指します。「CLSとの格闘」セクションで記録したCLSのバグは、この期間に本番環境へ影響した唯一のCSSの問題です。 ↩

  11. Google PageSpeed Insights(pagespeed.web.dev)は、任意の公開URLに対してLighthouseの監査を実行します。このツールはパフォーマンス、アクセシビリティ、ベストプラクティス、SEOを0〜100のスケールでテストします。blakecrosley.comは2026年2月時点で4つのカテゴリーすべてで100を記録しています。結果は誰でも検証でき、自己申告ではありません。 ↩

  12. Potvin, R. and Levenberg, J. (2016). “Why Google Stores Billions of Lines of Code in a Single Repository.” Communications of the ACM, 59(7), 78-87. doi.org/10.1145/2854146。Googleがモノレポを採用した動機の一部は、数千のプロジェクトにまたがって依存関係のバージョンを管理する組織的なコストにありました。これは、個々のプロジェクトのレベルでnode_modules/の肥大化を生むのと同じ力です。この論文は、依存関係の管理に費やされるエンジニアリング時間が、直接の依存関係ではなく推移的依存関係の数に比例することを記録しています。 ↩

  13. VercelのNext.jsパフォーマンスドキュメントは、デフォルトのLighthouseスコアがアプリケーションの複雑さによって変わることを認め、90を超えるスコアを得るための具体的な最適化(画像の最適化、フォントの読み込み、コード分割の設定)を推奨しています。nextjs.org/docs/app/building-your-application/optimizingを参照してください。70〜90という範囲は、これらの最適化を適用する前の、デフォルト設定のままの新規create-next-appプロジェクトを反映しています。この範囲は、Next.jsのGitHub Discussionsで報告されているコミュニティのベンチマークとも一致します。 ↩

  14. HTMXのバージョニング方針と後方互換性への取り組みは、htmx.org/migration-guide-htmx-1/に記載されています。1.xから2.xへの移行ガイドは、このプロジェクトの姿勢を示しています。破壊的変更はメジャーバージョンに限られ、明確に文書化され、移行のためのツールが用意されています。Carson Grossは、複数のカンファレンス講演と『Hypermedia Systems』(2023年)で、この後方互換性の原則を述べています。 ↩

関連記事

シグナルスコアリングパイプライン:決定論的ナレッジトリアージ

733行のPythonパイプラインが4つの次元でノートをスコアリングし、7,700以上のアイテムを決定論的にルーティングします。アルゴリズム、重み付け、そして正直な結果についてお話しします。

18 分で読める

76から100へ:Lighthouseパーフェクトスコア達成への道

個人ポートフォリオサイトのモバイルLighthouseパフォーマンススコアを76(CLS 0.493)から全カテゴリ100/100/100/100のパーフェクトスコアに改善した方法を解説します。

9 分で読める

複利エンジニアリング: 劣化ではなく加速するコードベース

コードベースは成長とともに遅くなるもの。私のは加速する。95のフック、44のスキル、14の設定が各機能を前回より安くする。

11 分で読める