Latest template; already-generated detection + recreate/replace flow

app.py

@@ -26,7 +26,7 @@ from PIL import Image
 from datasets import load_dataset
 from gradio_client import Client, handle_file
 
-from certificate_upload_module import upload_user_certificate
+from certificate_upload_module import upload_user_certificate, get_certificate_image_path
 
 HF_TOKEN = os.getenv("HF_TOKEN")
 
@@ -117,42 +117,37 @@ def lookup_participant(username: str):
 
 # ----------------------------------------------------------------------------- on login
 def on_load(profile: gr.OAuthProfile | None):
-    """Runs on page load. Drives which panel is shown and pre-fills the form."""
+    """Runs on page load. Drives which panel is shown, pre-fills the form, and — if the user
+    already generated a certificate — shows it and reveals the 'Recreate' control."""
+    hidden_cb = gr.update(visible=False, value=False)
+
     if profile is None:
         return (
             "Please sign in with your Hugging Face account to continue.",
-            gr.update(visible=False),   # main_interface
-            gr.update(visible=False),   # contact_box
-            "",                          # name
+            gr.update(visible=False),           # main_interface
+            gr.update(visible=False),           # contact_box
+            "",                                  # name
             gr.update(value="", visible=True),  # project
-            "",                          # data_status
+            "",                                  # data_status
+            None,                                # certificate_image
+            hidden_cb,                           # recreate_checkbox
+            "",                                  # generation_status
         )
 
     username = profile.username
     profile_name = profile.name or username
     state, full_name, space_name = lookup_participant(username)
 
-    if state == "not_found":
-        return (
-            f"Signed in as **{username}**.",
-            gr.update(visible=False),
-            gr.update(visible=True),
-            "",
-            gr.update(value="", visible=True),
-            "",
-        )
-    if state == "error":
+    if state in ("not_found", "error"):
         return (
             f"Signed in as **{username}**.",
             gr.update(visible=False),
             gr.update(visible=True),
-            "",
-            gr.update(value="", visible=True),
-            "",
+            "", gr.update(value="", visible=True), "",
+            None, hidden_cb, "",
         )
 
     name_value = full_name or profile_name
-
     if state == "found_project":
         status = f"✅ Found your submission — **{space_name}**. Review the details below, then generate."
         project_update = gr.update(value=space_name, visible=True)
@@ -163,13 +158,30 @@ def on_load(profile: gr.OAuthProfile | None):
         )
         project_update = gr.update(value="", visible=True)
 
+    # Already generated a certificate before? Fetch and show it.
+    existing = None
+    try:
+        existing = get_certificate_image_path(username)
+    except Exception:
+        existing = None
+
+    if existing:
+        gen_status = (
+            "📜 You've **already generated** a certificate (shown below). To change it, edit your "
+            "details, tick **Recreate certificate**, and click generate again — this **replaces** "
+            "your existing one (one certificate per participant)."
+        )
+        cb = gr.update(visible=True, value=False)
+    else:
+        gen_status = ""
+        cb = gr.update(visible=False, value=False)
+
     return (
         f"Signed in as **{username}**.",
         gr.update(visible=True),
         gr.update(visible=False),
-        name_value,
-        project_update,
-        status,
+        name_value, project_update, status,
+        existing, cb, gen_status,
     )
 
 
@@ -188,10 +200,10 @@ def generate_linkedin_url(participant_name, project_name):
 
 
 # ----------------------------------------------------------------------------- generate
-def create_certificate(participant_name, project_name,
+def create_certificate(participant_name, project_name, recreate,
                        oauth_token: gr.OAuthToken | None, profile: gr.OAuthProfile | None):
     if profile is None:
-        return None, None, "❌ Please sign in first to generate your certificate.", ""
+        return None, None, "❌ Please sign in first to generate your certificate.", "", gr.update(visible=False)
 
     username = profile.username
     state, _, _ = lookup_participant(username)
@@ -199,9 +211,25 @@ def create_certificate(participant_name, project_name,
         return None, None, (
             "❌ We couldn't find you in the Build Small Hackathon records, so we can't issue a "
             f"certificate. Please reach out on [Discord]({DISCORD_INVITE}) or email {CONTACT_EMAIL}."
-        ), ""
+        ), "", gr.update(visible=False)
     if state == "error":
-        return None, None, "❌ Couldn't reach the hackathon records right now. Please try again shortly.", ""
+        return None, None, "❌ Couldn't reach the hackathon records right now. Please try again shortly.", "", gr.update(visible=False)
+
+    # If they already have one and didn't ask to recreate, show it instead of duplicating.
+    existing_path = None
+    try:
+        existing_path = get_certificate_image_path(username)
+    except Exception:
+        existing_path = None
+
+    if existing_path and not recreate:
+        return (
+            existing_path, existing_path,
+            "ℹ️ You already have a certificate (shown above). To change it, edit your details, tick "
+            "**Recreate certificate**, and click generate again to replace it.",
+            generate_linkedin_url(participant_name or username, project_name or ""),
+            gr.update(visible=True, value=False),
+        )
 
     participant_name = (participant_name or "").strip() or (profile.name or username)
     project_name = (project_name or "").strip()
@@ -210,7 +238,6 @@ def create_certificate(participant_name, project_name,
         PROJECT_SECTION_WITH_NAME.replace("{project_name}", project_name)
         if project_name else PROJECT_SECTION_EMPTY
     )
-
     html = CERTIFICATE_HTML_TEMPLATE.replace("{participant_name}", participant_name)
     html = html.replace("{project_section}", project_section)
 
@@ -222,19 +249,22 @@ def create_certificate(participant_name, project_name,
         client = get_gradio_client()
         image_path = client.predict(html_file=handle_file(html_path), api_name="/predict")[0]
     except Exception as e:
-        return None, None, f"❌ Error generating certificate image: {e}", ""
+        return None, None, f"❌ Error generating certificate image: {e}", "", gr.update(visible=bool(existing_path))
 
-    # Save to the public gallery dataset
+    # Save (or replace) in the private gallery dataset
     try:
         cert_image = Image.open(image_path)
-        ok, msg = upload_user_certificate(cert_image, username)
-        save_note = msg if ok else f"(generated — gallery save note: {msg})"
+        ok, msg = upload_user_certificate(cert_image, username, overwrite=bool(existing_path))
+        if existing_path:
+            save_note = "🔁 This replaces your previous certificate in our records."
+        else:
+            save_note = msg if ok else f"(generated — gallery note: {msg})"
     except Exception as e:
         save_note = f"(generated — gallery save skipped: {e})"
 
     linkedin_url = generate_linkedin_url(participant_name, project_name)
     status = f"🎉 Your certificate is ready, {participant_name}! {save_note}"
-    return image_path, image_path, status, linkedin_url
+    return image_path, image_path, status, linkedin_url, gr.update(visible=True, value=False)
 
 
 def render_linkedin_button(url):
@@ -335,6 +365,9 @@ with gr.Blocks(title="Build Small — Certificate Generator") as demo:
             label="Project / Space name (editable, optional)",
             info="Auto-filled from your Build Small submission. Edit it, or leave blank for a certificate without a project.",
         )
+        recreate_checkbox = gr.Checkbox(
+            label="Recreate certificate (replaces my existing one)", value=False, visible=False,
+        )
         with gr.Row(elem_classes=["bs-generate"]):
             generate_btn = gr.Button("Generate my certificate", variant="primary", size="lg")
 
@@ -351,13 +384,14 @@ with gr.Blocks(title="Build Small — Certificate Generator") as demo:
     demo.load(
         fn=on_load,
         inputs=None,
-        outputs=[login_status, main_interface, contact_box, participant_name, project_name, data_status],
+        outputs=[login_status, main_interface, contact_box, participant_name, project_name,
+                 data_status, certificate_image, recreate_checkbox, generation_status],
     )
 
     generate_btn.click(
         fn=create_certificate,
-        inputs=[participant_name, project_name],
-        outputs=[certificate_image, certificate_file, generation_status, linkedin_state],
+        inputs=[participant_name, project_name, recreate_checkbox],
+        outputs=[certificate_image, certificate_file, generation_status, linkedin_state, recreate_checkbox],
     ).then(
         fn=lambda url: render_linkedin_button(url),
         inputs=[linkedin_state],

certificate_template.html

@@ -48,10 +48,7 @@ body{width:2000px;height:1414px;overflow:hidden;}
   display:flex;flex-direction:column;text-align:center;}
 
 /* ---- top bar ---- */
-.topbar{display:flex;justify-content:space-between;align-items:center;}
-.eyebrow{font-family:var(--font-mono);font-size:18px;font-weight:500;letter-spacing:.30em;
-  text-transform:uppercase;color:var(--ink-soft);display:inline-flex;align-items:center;gap:14px;}
-.eyebrow::before{content:"";width:34px;height:2px;background:var(--amber);display:inline-block;}
+.topbar{display:flex;justify-content:flex-end;align-items:center;}
 .coord{font-family:var(--font-mono);font-size:16px;letter-spacing:.10em;color:var(--ink-faint);}
 
 /* ---- lockup ---- */
@@ -66,8 +63,10 @@ body{width:2000px;height:1414px;overflow:hidden;}
   text-transform:uppercase;color:var(--forest);margin-top:30px;}
 .title{font-weight:900;font-stretch:122%;font-size:142px;line-height:.92;letter-spacing:-.02em;
   margin-top:12px;color:var(--ink);}
-.subtitle{font-family:var(--font-mono);font-size:21px;font-weight:500;letter-spacing:.42em;
-  text-transform:uppercase;color:var(--ink-2);margin-top:16px;}
+.doctype{display:inline-flex;align-items:center;justify-content:center;gap:24px;margin-top:22px;
+  font-family:var(--font-mono);font-size:32px;font-weight:600;letter-spacing:.28em;
+  text-transform:uppercase;color:var(--forest);}
+.doctype::before,.doctype::after{content:"";width:70px;height:2px;background:var(--amber);display:inline-block;}
 
 /* ---- body ---- */
 .body{flex-grow:1;display:flex;flex-direction:column;justify-content:center;}
@@ -139,8 +138,7 @@ body{width:2000px;height:1414px;overflow:hidden;}
 
   <div class="content">
     <div class="topbar">
-      <span class="eyebrow">Certificate of Participation</span>
-      <span class="coord">June 15, 2026</span>
+      <span class="coord">June 5–15, 2026</span>
     </div>
 
     <div class="lockup">
@@ -155,7 +153,7 @@ body{width:2000px;height:1414px;overflow:hidden;}
     <div>
       <div class="kicker">Hugging Face × Gradio Hackathon</div>
       <div class="title">Build Small</div>
-      <div class="subtitle">Small · Local · Yours</div>
+      <div class="doctype">Certificate of Participation</div>
     </div>
 
     <div class="body">

certificate_upload_module.py

@@ -17,8 +17,31 @@ CERTIFICATE_DATASET_NAME = "build-small-hackathon/build-small-certificates"
 HF_TOKEN = os.getenv("HF_TOKEN")
 
 
-def safe_add_certificate_to_dataset(certificate_image, hf_username, max_retries=5, retry_delay=3):
-    """Append a certificate image to the dataset, handling empty/existing datasets and dedup."""
+def get_certificate_image_path(hf_username):
+    """Return a local PNG path of this user's existing certificate, or None if they have none."""
+    if not hf_username or not hf_username.strip():
+        return None
+    uname = hf_username.strip().lower()
+    try:
+        ds = load_dataset(CERTIFICATE_DATASET_NAME, split="train", token=HF_TOKEN)
+    except Exception:
+        return None
+    try:
+        labels = [str(x).strip().lower() for x in ds["label"]]   # no image decode
+        if uname not in labels:
+            return None
+        img = ds[labels.index(uname)]["image"]                   # decode only the match
+        out = os.path.join(tempfile.gettempdir(), f"existing_cert_{uname}.png")
+        img.save(out, "PNG")
+        return out
+    except Exception as e:
+        logger.warning(f"get_certificate_image_path failed: {e}")
+        return None
+
+
+def safe_add_certificate_to_dataset(certificate_image, hf_username, overwrite=False, max_retries=5, retry_delay=3):
+    """Add a certificate image to the dataset. With overwrite=True, replace any existing
+    row for this username; otherwise refuse to duplicate."""
     try:
         if not hf_username or not hf_username.strip():
             return False, "❌ Error: HF username is required"
@@ -63,8 +86,13 @@ def safe_add_certificate_to_dataset(certificate_image, hf_username, max_retries=
 
         # Dedup by username (stored in the 'label' column)
         if existing_dataset is not None:
-            if hf_username in existing_dataset["label"]:
+            present = hf_username in existing_dataset["label"]
+            if present and not overwrite:
                 return True, f"a certificate for '{hf_username}' already exists in the gallery."
+            if present and overwrite:
+                existing_dataset = existing_dataset.filter(
+                    lambda ex: str(ex.get("label", "")).strip().lower() != hf_username.lower()
+                )
 
         with tempfile.TemporaryDirectory() as temp_dir:
             if isinstance(certificate_image, PILImage.Image):
@@ -79,7 +107,7 @@ def safe_add_certificate_to_dataset(certificate_image, hf_username, max_retries=
                 {"image": [temp_image_path], "label": [hf_username]}
             ).cast_column("image", Image())
 
-            if existing_dataset is not None and not is_empty_dataset:
+            if existing_dataset is not None and not is_empty_dataset and len(existing_dataset) > 0:
                 combined_dataset = concatenate_datasets([existing_dataset, new_dataset])
             else:
                 combined_dataset = new_dataset
@@ -99,10 +127,10 @@ def safe_add_certificate_to_dataset(certificate_image, hf_username, max_retries=
         return False, f"❌ Certificate upload failed: {str(e)}"
 
 
-def upload_user_certificate(certificate_image, hf_username):
+def upload_user_certificate(certificate_image, hf_username, overwrite=False):
     """Public entry point — returns (success, message)."""
     if not certificate_image:
         return False, "❌ No certificate image provided"
     if not hf_username or not hf_username.strip():
         return False, "❌ HF username is required"
-    return safe_add_certificate_to_dataset(certificate_image, hf_username)
+    return safe_add_certificate_to_dataset(certificate_image, hf_username, overwrite=overwrite)