diff --git a/AGENTS.md b/AGENTS.md index d13904f16..8e03070fe 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -538,7 +538,7 @@ Form submissions (`
`) ride the same pipeline. GET forms prom Wire-byte optimization is automatic: the router sends `X-Webjs-Have` listing marker paths it has; the server short-circuits at the deepest match and returns only the divergent fragment. Rapid clicks are safe (prior fetches abort, nav-tokens prevent stale reverts). Scroll position is captured + restored on back/forward. -**Production benefits from HTTP/2 at the edge.** Per-file ESM rides HTTP/2 multiplex to be competitive with bundling. PaaS edges (Railway, Fly, Render, Vercel, Cloudflare, Heroku) serve HTTP/2 automatically; bare-VM self-hosters put nginx / Caddy / Traefik in front. `webjs start` itself speaks plain HTTP/1.1. +**Production benefits from HTTP/2 at the edge.** Per-file ESM rides HTTP/2 multiplex to be competitive with bundling. PaaS edges (Railway, Fly, Render, Vercel, Cloudflare, Heroku) serve HTTP/2 automatically. Bare-VM self-hosters put nginx / Caddy / Traefik in front. The production server (`npm run start`) speaks plain HTTP/1.1. For partial-swap NOT tied to a folder layout, wrap in ``. See `agent-docs/advanced.md` for the full mechanism. diff --git a/agent-docs/advanced.md b/agent-docs/advanced.md index c8a919fd1..2553b158e 100644 --- a/agent-docs/advanced.md +++ b/agent-docs/advanced.md @@ -26,7 +26,7 @@ Five stacked zero-build optimizations: The SSR pass knows every custom element in the final HTML. A startup module-graph scan adds their transitive import dependencies too. All preload hints are deduplicated and emitted in ``. -2. **HTTP/2 multiplex at the edge.** `webjs start` itself speaks plain +2. **HTTP/2 multiplex at the edge.** The production server (`npm run start`) speaks plain HTTP/1.1. PaaS edges (Railway, Fly, Render, Vercel, Cloudflare Pages, Heroku) and reverse proxies (nginx, Caddy, Traefik) speak HTTP/2 to the browser and proxy 1.1 to the container, fetching many module @@ -64,8 +64,8 @@ production. The Rails 7+ / Hotwire pattern: imports. This is what eliminates the perceived gap vs a bundle. - **HTTP/2 multiplex** is what makes per-file serving competitive: one TCP+TLS handshake, many module fetches in parallel over the same - connection. `webjs start` itself speaks plain HTTP/1.1. TLS + HTTP/2 - is the proxy's job. PaaS edges (Railway, Fly, Render, Vercel, + connection. The production server (`npm run start`) speaks plain HTTP/1.1. + TLS + HTTP/2 is the proxy's job. PaaS edges (Railway, Fly, Render, Vercel, Cloudflare Pages, Heroku) do this automatically. For bare-VM deploys, put nginx, Caddy, or Traefik in front.