From 9482de6ffad9db8bc79d727fa34752b200c99449 Mon Sep 17 00:00:00 2001
From: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>
Date: Mon, 25 May 2026 00:49:16 -0700
Subject: [PATCH] Surface the 20 MB CSV upload cap in the upload UI (#11)

Two changes:

- frontend/index.html: add an info-circle hint right below the file
  input - "Max 20 MB - runs in your browser". The cap is now visible
  before the user picks a file.
- frontend/js/app.js: rewrite the oversize error message to the
  friendly text proposed in the issue ("File is too large for the
  browser runtime - please subsample first (max 20 MB)."). The
  client-side reject already exists at line 446-448 and runs before
  the pyCallBinary call.

Files within the limit upload exactly as before. No Pyodide-side
changes - CLAUDE.md is explicit that the 20 MB cap is dictated by
Pyodide's WASM heap and should be surfaced rather than "fixed".
---
 frontend/index.html | 3 +++
 frontend/js/app.js  | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/frontend/index.html b/frontend/index.html
index 4313922..81f2911 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -367,6 +367,9 @@ <h5 class="modal-title d-flex align-items-center gap-2">
                                 </div>
                             </div>
                             <input type="file" class="form-control form-control-sm" id="fileInput" accept=".csv">
+                            <div class="form-text small mt-1">
+                                <i class="bi bi-info-circle"></i> Max 20 MB &middot; runs in your browser
+                            </div>
                             <div id="uploadPreview" class="mt-2" style="display: none;">
                                 <small class="text-muted">Preview:</small>
                                 <div class="table-responsive" style="max-height: 150px;">
diff --git a/frontend/js/app.js b/frontend/js/app.js
index 0641d05..4bbeacd 100644
--- a/frontend/js/app.js
+++ b/frontend/js/app.js
@@ -444,7 +444,7 @@ async function uploadFile() {
     try {
         const file = fileInput.files[0];
         if (file.size > 20 * 1024 * 1024) {
-            throw new Error('File exceeds 20 MB cap — Pyodide runs out of memory on large CSVs.');
+            throw new Error('File is too large for the browser runtime — please subsample first (max 20 MB).');
         }
         const buf = new Uint8Array(await file.arrayBuffer());
         const data = await pyCallBinary('upload_csv', buf, [file.name]);