1 Commits

Author SHA1 Message Date
medievalshell 35f16a6745 docs: PERFORMANCE.md — client + server recipe for the 4s cold load
Standalone performance guide for the Nitro V3 client, covering both
sides of the cold-load story so a deployer doesn't have to cross-
reference two repos to get from 60-90 s down to 4 s.

Sections:

1. Three Nitro-side changes that matter (code split, LoadingView with
   real progress, remember-token URL capture)
2. Vite manualChunks — why vendor-first ordering matters, why pixi
   stays inlined, expected chunk sizes after yarn build
3. LoadingView state model + the 12-stage progress table + the
   pre-React shell template in scripts/write-asset-loader.mjs
4. Remember-token capture from URL → SetRememberLogin, with DevTools
   verification of nitro.auth.remember localStorage entry
5. nginx gzip (the single biggest win at ~17x for JSON5) + 30-day
   cache headers on gamedata + try_files manifest fallback
6. Windows + IIS equivalent — URL Rewrite + ARR reverse proxy to
   Node, Dynamic Compression toggle, web.config snippets,
   trade-offs (CPU cost, JDBC quirks, shared hosting caveat)
7. End-to-end verification probes — chunks present, gzip on, dir
   fallback works, progress bar renders, remember-token persisted

Cross-references medievalshell/InertiaCMS:docs/PERFORMANCE.md for the
matching CMS-side application config (SSO TTL, /api/auth/remember
endpoint, migrations).
2026-05-21 02:49:51 +02:00