From e61389dde86ae40006a08392a70440c7f185ff84 Mon Sep 17 00:00:00 2001
From: Project516 <138796702+Project516@users.noreply.github.com>
Date: Sat, 7 Nov 2026 18:22:37 -0600
Subject: [PATCH 1/2] docs: say that GitHub Pages must deploy from Actions to
 serve jdk/image.jar

---
 README.md       | 4 +++-
 docs/browser.md | 4 ++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 81698f1..8b37759 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,9 @@ and its page API matches CheerpJ's, so existing pages can switch.
 pnpm add @project516/java-web
 ```
 
-Serve `node_modules/@project516/java-web/dist/` as static files, then:
+Serve `node_modules/@project516/java-web/dist/` as static files (on GitHub
+Pages, deploy from Actions: a `gh-pages` branch cannot hold the 120 MB
+`jdk/image.jar`), then:
 
 ```html
 <script src="java-web.js"></script>
diff --git a/docs/browser.md b/docs/browser.md
index 95eb165..855e21a 100644
--- a/docs/browser.md
+++ b/docs/browser.md
@@ -10,6 +10,10 @@ next to itself, or where `cheerpjInit({ runtime: "/path/to/dist/" })` says.
   typical start reads, and `jdk/javac.pack` what javac adds. A host that
   compresses ranged responses still works, at the cost of one full download of
   `jdk/image.jar` (about 120 MB).
+- `jdk/image.jar` is over GitHub's 100 MB limit for a file in a git
+  repository, so a site published by pushing a `gh-pages` branch cannot hold
+  it. GitHub Pages deployed from Actions (`actions/upload-pages-artifact`)
+  serves it, Range requests included.
 - The JIT compiles hot Java methods with `new Function`, so a page with a
   Content Security Policy needs `'unsafe-eval'` in `script-src`. Without it,
   Java still runs, only interpreted.

From 1fcb25d602ee33cec240dc732bcf2117f965abbf Mon Sep 17 00:00:00 2001
From: Project516 <138796702+Project516@users.noreply.github.com>
Date: Sat, 7 Nov 2026 18:28:48 -0600
Subject: [PATCH 2/2] docs: give the /app/ path of a file on a GitHub Pages
 project site

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8b37759..64b36ba 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,8 @@ pnpm add @project516/java-web
 
 Serve `node_modules/@project516/java-web/dist/` as static files (on GitHub
 Pages, deploy from Actions: a `gh-pages` branch cannot hold the 120 MB
-`jdk/image.jar`), then:
+`jdk/image.jar`; on a project site, `/app/` is `user.github.io`, so files are
+under `/app/<repo>/`), then:
 
 ```html
 <script src="java-web.js"></script>