split-micro-app

Trace which modules pull in heavy store code with a build-time module trace, then stub store hubs per SSR environment with callable empty-state hooks. Client-gate heavy routes and bypass barrel exports; this approach cut one app's SSR bundle from 9.84MB to 1.78MB gzip.

Build with a stable CDN base URL, upload the hashed client assets to an R2 bucket, then run wrangler deploy against the server build. Content-hashed filenames make uploads incremental, so one prefix per app is safe across build origins.

Use prerendering with ssr: false when every page is config-free at render time; the worker becomes a small static picker with no SSR stubs. Use SSR when pages need per-request data, accepting the bundle-weight work that comes with it.

Serving a locale-prefixed prerendered document at the plain route breaks hydration: React Router finds no context for the prefixed route id and re-renders the whole document. Build one pass per locale so each document lives at its canonical path.

The dev shell handler falls back to the main SPA HTML when the root-level index template file is missing, returning a 200 that silently serves the wrong app. Verify the template file exists at the repo root and points at the app's entry.

No. Preview uploads count against the 100-version rollback window of a script, so previews must target a separate sibling Worker with its own name. Bootstrap the preview Worker once with wrangler deploy before the first version upload.