feat: add pagination to My QR Codes dashboard

app.py

@@ -340,6 +340,26 @@ def _coerce_pil_image(image: Any) -> Image.Image:
     return Image.fromarray(np.asarray(image))
 
 
+def _build_dashboard_page_view(
+    records: list[dict[str, Any]],
+    current_page: int = 1,
+):
+    table_rows, row_map, summary, safe_page, total_pages = build_generation_table_rows(
+        records,
+        page=current_page,
+    )
+    page_label = f"Page {safe_page} of {total_pages}"
+    return (
+        summary,
+        table_rows,
+        row_map,
+        safe_page,
+        page_label,
+        gr.update(interactive=safe_page > 1),
+        gr.update(interactive=safe_page < total_pages),
+    )
+
+
 def _dashboard_empty_payload(message: str):
     return (
         message,
@@ -347,6 +367,10 @@ def _dashboard_empty_payload(message: str):
         [],
         [],
         [],
+        1,
+        "",
+        gr.update(interactive=False),
+        gr.update(interactive=False),
         None,
         "Click a row in the table to inspect analytics and reload settings.",
         "",
@@ -397,6 +421,10 @@ def _load_my_qr_dashboard(
             [],
             records,
             [],
+            1,
+            "",
+            gr.update(interactive=False),
+            gr.update(interactive=False),
             None,
             "No saved QR codes yet. Generate one while signed in, then come back here.",
             "",
@@ -410,13 +438,17 @@ def _load_my_qr_dashboard(
             gr.update(visible=False),
         )
 
-    table_rows, row_map, summary = build_generation_table_rows(records)
+    summary, table_rows, row_map, safe_page, page_label, prev_update, next_update = _build_dashboard_page_view(records, 1)
     return (
         str(payload.get("status") or "Loaded."),
         summary,
         table_rows,
         records,
         row_map,
+        safe_page,
+        page_label,
+        prev_update,
+        next_update,
         None,
         "Click a row in the table to inspect a saved QR and reload settings.",
         "",
@@ -530,21 +562,81 @@ def _select_my_qr_generation_from_table(
     return _select_my_qr_generation(records, selected_index, request)
 
 
+def _change_my_qr_page(
+    records: list[dict[str, Any]],
+    current_page: int,
+    delta: int,
+):
+    if not records:
+        return (
+            "",
+            [],
+            [],
+            1,
+            "",
+            gr.update(interactive=False),
+            gr.update(interactive=False),
+            None,
+            "No saved QR codes are loaded yet.",
+            "",
+            [],
+            "",
+            "",
+            "{}",
+            gr.update(visible=False),
+            gr.update(visible=False),
+            gr.update(visible=False),
+            gr.update(visible=False),
+        )
+    summary, table_rows, row_map, safe_page, page_label, prev_update, next_update = _build_dashboard_page_view(
+        records,
+        current_page + delta,
+    )
+    return (
+        summary,
+        table_rows,
+        row_map,
+        safe_page,
+        page_label,
+        prev_update,
+        next_update,
+        None,
+        "Click a row in the table to inspect a saved QR and reload settings.",
+        "",
+        [],
+        "",
+        "",
+        "{}",
+        gr.update(visible=False),
+        gr.update(visible=False),
+        gr.update(visible=False),
+        gr.update(visible=False),
+    )
+
+
 def _update_my_qr_destination(
     records: list[dict[str, Any]],
+    current_page: int,
     selected_index: int | None,
     new_destination: str,
     request: Union[gr.Request, None] = None,
 ):
     if not records or selected_index is None:
         detail = _select_my_qr_generation(records, None, request)
-        table_rows, row_map, summary = build_generation_table_rows(records)
+        summary, table_rows, row_map, safe_page, page_label, prev_update, next_update = _build_dashboard_page_view(
+            records,
+            current_page,
+        )
         return (
             "Select a saved QR first.",
             summary,
             table_rows,
             records,
             row_map,
+            safe_page,
+            page_label,
+            prev_update,
+            next_update,
             *detail,
         )
 
@@ -557,30 +649,47 @@ def _update_my_qr_destination(
         )
     except DashboardError as exc:
         detail = _select_my_qr_generation(records, selected_index, request)
-        table_rows, row_map, summary = build_generation_table_rows(records)
+        summary, table_rows, row_map, safe_page, page_label, prev_update, next_update = _build_dashboard_page_view(
+            records,
+            current_page,
+        )
         return (
             f"Could not update QR destination: {exc}",
             summary,
             table_rows,
             records,
             row_map,
+            safe_page,
+            page_label,
+            prev_update,
+            next_update,
             *detail,
         )
     except Exception as exc:
         print("[dashboard-update-destination]", traceback.format_exc())
         detail = _select_my_qr_generation(records, selected_index, request)
-        table_rows, row_map, summary = build_generation_table_rows(records)
+        summary, table_rows, row_map, safe_page, page_label, prev_update, next_update = _build_dashboard_page_view(
+            records,
+            current_page,
+        )
         return (
             f"Could not update QR destination: {_format_exception_message(exc)}",
             summary,
             table_rows,
             records,
             row_map,
+            safe_page,
+            page_label,
+            prev_update,
+            next_update,
             *detail,
         )
 
     updated_records = result["records"]
-    table_rows, row_map, summary = build_generation_table_rows(updated_records)
+    summary, table_rows, row_map, safe_page, page_label, prev_update, next_update = _build_dashboard_page_view(
+        updated_records,
+        current_page,
+    )
     status = "Updated QR destination."
     short_url = str(result.get("short_url") or "").strip()
     normalized_url = str(result.get("normalized_url") or "").strip()
@@ -594,6 +703,10 @@ def _update_my_qr_destination(
         table_rows,
         updated_records,
         row_map,
+        safe_page,
+        page_label,
+        prev_update,
+        next_update,
         *detail,
     )
 
@@ -6814,6 +6927,7 @@ with gr.Blocks(delete_cache=(3600, 3600), css=DASHBOARD_CSS) as demo:
             )
             my_qr_records_state = gr.State([])
             my_qr_row_map_state = gr.State([])
+            my_qr_page_state = gr.State(value=1)
             my_qr_selected_index_state = gr.State(value=None)
             my_qr_table_summary = gr.Markdown("No saved QR codes loaded yet.")
             my_qr_table = gr.Dataframe(
@@ -6826,6 +6940,10 @@ with gr.Blocks(delete_cache=(3600, 3600), css=DASHBOARD_CSS) as demo:
                 value=[],
                 wrap=True,
             )
+            with gr.Row():
+                my_qr_prev_page_btn = gr.Button("← Previous", interactive=False)
+                my_qr_page_label = gr.Markdown("")
+                my_qr_next_page_btn = gr.Button("Next →", interactive=False)
             with gr.Row():
                 with gr.Column(scale=1):
                     my_qr_detail_image = gr.HTML(
@@ -6892,6 +7010,10 @@ with gr.Blocks(delete_cache=(3600, 3600), css=DASHBOARD_CSS) as demo:
                     my_qr_table,
                     my_qr_records_state,
                     my_qr_row_map_state,
+                    my_qr_page_state,
+                    my_qr_page_label,
+                    my_qr_prev_page_btn,
+                    my_qr_next_page_btn,
                     my_qr_selected_index_state,
                     my_qr_detail_markdown,
                     my_qr_detail_image,
@@ -6915,6 +7037,10 @@ with gr.Blocks(delete_cache=(3600, 3600), css=DASHBOARD_CSS) as demo:
                     my_qr_table,
                     my_qr_records_state,
                     my_qr_row_map_state,
+                    my_qr_page_state,
+                    my_qr_page_label,
+                    my_qr_prev_page_btn,
+                    my_qr_next_page_btn,
                     my_qr_selected_index_state,
                     my_qr_detail_markdown,
                     my_qr_detail_image,
@@ -6947,15 +7073,69 @@ with gr.Blocks(delete_cache=(3600, 3600), css=DASHBOARD_CSS) as demo:
                 ],
             )
 
+            my_qr_prev_page_btn.click(
+                fn=lambda records, current_page: _change_my_qr_page(records, current_page, -1),
+                inputs=[my_qr_records_state, my_qr_page_state],
+                outputs=[
+                    my_qr_table_summary,
+                    my_qr_table,
+                    my_qr_row_map_state,
+                    my_qr_page_state,
+                    my_qr_page_label,
+                    my_qr_prev_page_btn,
+                    my_qr_next_page_btn,
+                    my_qr_selected_index_state,
+                    my_qr_detail_markdown,
+                    my_qr_detail_image,
+                    my_qr_scan_breakdown,
+                    my_qr_current_destination,
+                    my_qr_new_destination,
+                    my_qr_settings_json,
+                    my_qr_settings_accordion,
+                    load_standard_from_dashboard_btn,
+                    load_artistic_from_dashboard_btn,
+                    my_qr_retarget_group,
+                ],
+            )
+
+            my_qr_next_page_btn.click(
+                fn=lambda records, current_page: _change_my_qr_page(records, current_page, 1),
+                inputs=[my_qr_records_state, my_qr_page_state],
+                outputs=[
+                    my_qr_table_summary,
+                    my_qr_table,
+                    my_qr_row_map_state,
+                    my_qr_page_state,
+                    my_qr_page_label,
+                    my_qr_prev_page_btn,
+                    my_qr_next_page_btn,
+                    my_qr_selected_index_state,
+                    my_qr_detail_markdown,
+                    my_qr_detail_image,
+                    my_qr_scan_breakdown,
+                    my_qr_current_destination,
+                    my_qr_new_destination,
+                    my_qr_settings_json,
+                    my_qr_settings_accordion,
+                    load_standard_from_dashboard_btn,
+                    load_artistic_from_dashboard_btn,
+                    my_qr_retarget_group,
+                ],
+            )
+
             update_my_qr_destination_btn.click(
                 fn=_update_my_qr_destination,
-                inputs=[my_qr_records_state, my_qr_selected_index_state, my_qr_new_destination],
+                inputs=[my_qr_records_state, my_qr_page_state, my_qr_selected_index_state, my_qr_new_destination],
                 outputs=[
                     dashboard_status,
                     my_qr_table_summary,
                     my_qr_table,
                     my_qr_records_state,
                     my_qr_row_map_state,
+                    my_qr_page_state,
+                    my_qr_page_label,
+                    my_qr_prev_page_btn,
+                    my_qr_next_page_btn,
                     my_qr_selected_index_state,
                     my_qr_detail_markdown,
                     my_qr_detail_image,

hf_dashboard.py

@@ -4,6 +4,7 @@ import copy
 import hashlib
 import io
 import json
+import math
 import os
 import re
 from collections import Counter
@@ -1012,20 +1013,36 @@ def update_generation_destination(
 def build_generation_table_rows(
     records: list[dict[str, Any]],
     *,
+    page: int = 1,
     limit: int = 10,
-) -> tuple[list[list[Any]], list[int], str]:
-    visible_records = list(records[: max(0, limit)])
-    row_map = list(range(len(visible_records)))
+) -> tuple[list[list[Any]], list[int], str, int, int]:
+    safe_limit = max(1, int(limit))
+    total_records = len(records)
+    total_pages = max(1, math.ceil(total_records / safe_limit))
+    safe_page = min(max(1, int(page)), total_pages)
+    start_idx = (safe_page - 1) * safe_limit
+    end_idx = start_idx + safe_limit
+    visible_records = list(records[start_idx:end_idx])
+    row_map = list(range(start_idx, start_idx + len(visible_records)))
     table_rows: list[list[Any]] = []
-    for position, record in enumerate(visible_records, start=1):
+    for position, record in enumerate(visible_records, start=start_idx + 1):
         created = str(record.get("created_at") or "")[:16].replace("T", " ")
         qr_mode = str(record.get("qr_mode") or "qr").title()
         destination = str(record.get("destination_url_original") or "—")
         short_url = str(record.get("short_url") or "—")
         status = str(record.get("status") or "unknown")
         table_rows.append([position, created, qr_mode, destination, short_url, status])
-    summary = f"Showing {len(visible_records)} of {len(records)} saved QR code(s). Click a row to inspect it."
-    return table_rows, row_map, summary
+    if total_records:
+        shown_start = start_idx + 1
+        shown_end = start_idx + len(visible_records)
+        range_label = f"Showing {shown_start}-{shown_end} of {total_records}"
+    else:
+        range_label = "Showing 0-0 of 0"
+    summary = (
+        f"{range_label} saved QR code(s). "
+        f"Page {safe_page} of {total_pages}. Click a row to inspect it."
+    )
+    return table_rows, row_map, summary, safe_page, total_pages
 
 
 def resolve_generation_index_from_table_event(

tests-unit/hf_dashboard_test.py

@@ -466,14 +466,41 @@ def test_build_generation_table_rows_limits_to_10_and_returns_row_map() -> None:
             }
         )
 
-    table_rows, row_map, summary = hf_dashboard.build_generation_table_rows(rows)
+    table_rows, row_map, summary, page, total_pages = hf_dashboard.build_generation_table_rows(rows)
 
     assert len(table_rows) == 10
     assert len(row_map) == 10
     assert row_map == list(range(10))
     assert table_rows[0][0] == 1
     assert table_rows[0][2] in {"Standard", "Artistic"}
-    assert "Showing 10 of 12" in summary
+    assert "Showing 1-10 of 12" in summary
+    assert page == 1
+    assert total_pages == 2
+
+
+def test_build_generation_table_rows_returns_second_page_slice() -> None:
+    rows = []
+    for idx in range(12):
+        rows.append(
+            {
+                "id": f"gen-{idx}",
+                "created_at": f"2026-05-31T1{idx % 10}:00:00+00:00",
+                "qr_mode": "standard",
+                "destination_url_original": f"https://example.com/{idx}",
+                "short_url": f"https://qrcut.co/{idx}",
+                "status": "completed",
+            }
+        )
+
+    table_rows, row_map, summary, page, total_pages = hf_dashboard.build_generation_table_rows(rows, page=2)
+
+    assert len(table_rows) == 2
+    assert row_map == [10, 11]
+    assert table_rows[0][0] == 11
+    assert table_rows[1][0] == 12
+    assert "Showing 11-12 of 12" in summary
+    assert page == 2
+    assert total_pages == 2
 
 
 def test_resolve_generation_index_from_table_event_handles_tuple_index() -> None: