Finalize hackathon README field notes and UI

Co-authored-by: Cursor <cursoragent@cursor.com>

.env.example

@@ -0,0 +1,23 @@
+# Copy to .env locally; use HF Space Secrets in deployment.
+# Frontend never reads these — backend model_router only.
+APP_ENV=development
+MAX_ROUNDS=6
+
+DEFAULT_MODEL_MODE=premium_nvidia
+
+# NVIDIA Nemotron 3 Nano Omni 30B-A3B (primary premium model — backend-only API)
+NVIDIA_API_KEY=
+NVIDIA_BASE_URL=https://integrate.api.nvidia.com/v1
+NVIDIA_OMNI_MODEL=nvidia/nemotron-3-nano-omni-30b-a3b-reasoning
+
+
+# Hugging Face (model download / Space)
+HF_TOKEN=
+
+
+
+# Feature flags
+ENABLE_DECK_CRITIQUE=true
+ENABLE_DEAL_BATTLE=true
+ENABLE_VOICE_MODE=true
+

.gitignore

@@ -7,47 +7,65 @@
 __pycache__/
 *.py[cod]
 *$py.class
+*.egg
 *.egg-info/
 .eggs/
 dist/
 build/
+pip-wheel-metadata/
 .pytest_cache/
 .mypy_cache/
 .ruff_cache/
 .coverage
 htmlcov/
+*.cover
+.hypothesis/
 
 # Virtual environments
 venv/
 .venv/
 env/
+ENV/
 
 # OS / editor
 .DS_Store
 Thumbs.db
+Desktop.ini
 .idea/
 .vscode/
 *.swp
 *.swo
+*~
 
 # Node (if added later)
 node_modules/
+npm-debug.log*
 
-# Gradio runtime / uploads
+# Gradio / Hugging Face runtime
 .gradio/
+flagged/
 
 # Local model weights & generated media (large / machine-specific)
 models/
 *.gguf
+*.bin
+*.safetensors
 *.wav
 *.mp3
+*.webm
+uploads/
+tmp/
+temp/
 
-# Local-only folders
-docs/
-scripts/
-tests/
+# Logs & local databases
+*.log
+*.sqlite
+*.sqlite3
 
-# Environment files
-.env
-.env.*
-.env.example
+# Jupyter
+.ipynb_checkpoints/
+
+# README screenshots (hosted via GitHub raw URLs on HF Space)
+assets/*.png
+frontend/assets/battle_fight.png
+frontend/assets/landing_page.png

FIELD_NOTES.md

@@ -0,0 +1,131 @@
+# Field Notes: PitchFight AI
+
+Build log for the Hugging Face **Build Small Hackathon** (Backyard AI track).  
+PitchFight AI is a practice arena for student founders — not a replacement for real mentors, investors, or hackathon judges.
+
+---
+
+## What we built
+
+PitchFight AI is an AI founder pressure arena where student builders:
+
+1. Enter a startup idea (quick pitch, advanced form, or voice pitch)
+2. Get an AI-structured founder briefing
+3. Choose a judge persona and difficulty mode
+4. Survive multi-round pitch Q&A in a battle-style UI
+5. Enter an optional deal-style pressure round
+6. Receive a scorecard with coaching and a retry path for the weakest answer
+
+**Stack:** Hugging Face Spaces · Gradio Server (`app.py`) · custom HTML/CSS/JS frontend · NVIDIA Nemotron API (backend-only) · `ffmpeg` for audio · optional MongoDB persistence.
+
+The browser talks only to `/api/*`. Model calls never run in the frontend.
+
+---
+
+## Why this exists
+
+Most student founders rehearse slides alone or with friends who are too nice. The first hard questions usually come from a real panel — and that is when answers fall apart.
+
+We wanted a low-friction place to practice **under pressure** before that moment. The goal is coaching and repetition, not pretending an AI judge is a substitute for human feedback.
+
+---
+
+## Product decisions
+
+- **Arena, not chatbot.** Flow is staged: landing → briefing → battle → deal → scorecard. It should feel like stepping into a fight, not opening a generic assistant.
+- **Structured briefing first.** Raw ideas get structured before the judge attacks, so users practice defending a clear narrative.
+- **Personas + difficulty.** Skeptical VC, technical judge, and hackathon judge modes change tone and pressure without swapping the whole product.
+- **Scorecard over vibes.** Output is actionable: what landed, what was weak, what to rewrite — not just “good job.”
+- **Voice as an entry path, not the whole app.** Voice pitch and voice answers are supported where enabled, but text mode stays fully usable.
+
+---
+
+## AI judge design
+
+Judges are prompt-driven personas routed through a single backend model layer. Design choices:
+
+- **Follow-up questions, not monologues.** Each round pushes on claims, gaps, and vague traction.
+- **Persona-specific pressure.** VC mode leans market and defensibility; technical mode probes AI necessity and feasibility; hackathon mode focuses on demo clarity and MVP.
+- **Attack tags / rubric hooks** (in config) keep scoring and feedback aligned with what was actually said, not generic startup advice.
+- **Retry weakest answer.** After the scorecard, users can rework one weak response — closer to coaching than a one-shot grade.
+
+This is simulated judgment for practice. Real panels bring context, chemistry, and standards no API can fully replicate.
+
+---
+
+## NVIDIA Nemotron usage
+
+- **API:** `https://integrate.api.nvidia.com/v1`
+- **Primary model:** `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`
+- **Key handling:** `NVIDIA_API_KEY` lives in `.env` locally and in **HF Space Secrets** in deployment — never in the frontend or git.
+- **Routing:** `core/model_router.py` → `core/nvidia_client.py` for judge questions, structuring, scoring, rewrites, and voice-related paths where enabled.
+
+**Practical note:** This is a reasoning model. It can spend tokens on internal reasoning before the visible reply. We tuned `max_tokens` per task so the user-facing answer stays in character and concise.
+
+We use Nemotron as the main inference backend for the demo build. We are **not** claiming fine-tuning or custom model training.
+
+---
+
+## Custom UI / Off Brand decisions
+
+We deliberately avoided default Gradio widgets for the product surface.
+
+- **Custom frontend** (`frontend/`) — cinematic landing, briefing layout, battle stage, deal screen, scorecard.
+- **Game-like presentation** — spotlights, arena framing, persona cards, pressure-meter styling. Pitch practice should feel memorable in a demo, not like a form filler.
+- **Gradio as host, not as UI.** `app.py` serves the static frontend and REST API; Gradio is the deployment shell on Spaces.
+
+This aligns with an **Off-Brand** spirit (custom experience on HF infrastructure) without claiming we built a different framework.
+
+---
+
+## Hugging Face deployment notes
+
+- **Space type:** Gradio Space, `app_file: app.py`, custom `/` homepage serving `frontend/index.html`.
+- **Secrets:** `NVIDIA_API_KEY` required; optional flags for voice, deal battle, deck critique, MongoDB.
+- **System deps:** `packages.txt` includes `ffmpeg` for audio pipelines.
+- **Layout tuning:** Landing and briefing screens were adjusted for the Spaces desktop viewport — including the white HF navbar above the app iframe. We use `100svh` / `100dvh` with safe padding and a small JS viewport sync so the hero fills the **visible app area** without a dead band at the bottom or content hidden under chrome.
+
+Local dev at `127.0.0.1:7860` does not show the HF navbar; we tested both locally and in the live Space while iterating on layout.
+
+---
+
+## What worked well
+
+- **Backend-only inference** kept secrets out of the browser and simplified deployment.
+- **Custom UI + `/api/*` contract** made it easy to iterate on flow without fighting Gradio components.
+- **Phased product shape** (brief → battle → deal → scorecard) reads clearly in a short demo.
+- **Persona and difficulty toggles** give variety without multiplying model integrations.
+- **Honest coaching tone** in prompts and scorecard copy — useful feedback without overclaiming “investor approval.”
+
+---
+
+## Tradeoffs and limitations
+
+- **Coaching tool, not truth.** AI judges can be sharp but wrong, repetitive, or too harsh. Users still need humans for real validation.
+- **Reasoning model latency and token budget.** Longer waits and token tuning are part of the tradeoff for quality follow-ups.
+- **Voice depends on environment.** `ffmpeg`, browser permissions, and API availability affect voice mode reliability on Spaces.
+- **Deck critique / MongoDB** are optional paths — not every deployment enables them.
+- **No production-scale eval suite.** We did not run formal benchmarks or user studies for this hackathon build; quality is judged by manual demo runs and iterative prompt tuning.
+- **Layout is viewport-sensitive.** Short or embedded viewports may still need scroll on dense screens (e.g. advanced briefing); landing is tuned for HF desktop first.
+
+---
+
+## Submission evidence
+
+| Item | Link |
+|------|------|
+| **Live Space** | `[Add your HF Space URL]` |
+| **Demo video** | `[Add demo video URL]` |
+| **Hugging Face blog / write-up** | `[Add blog or post URL]` |
+
+**Repo highlights for judges:** `app.py` (API + frontend host) · `core/api_handlers.py` · `core/model_router.py` · `frontend/` (custom UI) · `docs/DOCUMENTATION.md` (technical depth)
+
+---
+
+### Not claiming
+
+- Not claiming **OpenBMB / MiniCPM**
+- Not claiming **Modal**
+- Not claiming **Tiny Titan**
+- Not claiming **Off the Grid**
+- Not claiming **fine-tuning**

README.md

@@ -4,63 +4,290 @@ emoji: ⚔️
 colorFrom: red
 colorTo: yellow
 sdk: gradio
+sdk_version: 6.17.3
+python_version: 3.12
 app_file: app.py
 pinned: true
+license: mit
+short_description: An AI founder pressure arena for practicing startup pitches.
+tags:
+  - gradio
+  - build-small-hackathon
+  - backyard-ai
+  - startup
+  - pitch-practice
+  - founder-tooling
+  - voice-ai
+  - nvidia
+  - nemotron
+  - track:backyard
+  - sponsor:nvidia
+  - achievement:offbrand
+  - achievement:fieldnotes
+  - achievement:bestdemo
+  - best-demo
+  - community-choice
 ---
 
-# PitchFight AI
+<div align="center">
 
-**Your first tough pitch should not be in front of a real judge.**
+# ⚔️ PitchFight AI
 
-PitchFight AI is a voice-and-text sparring arena for student founders. Practice a startup pitch, get grilled by realistic AI judges, negotiate a deal round, and walk away with a scorecard that shows what landed and what to fix next.
+### Your first tough pitch should not be in front of a real judge.
 
-Built for the Hugging Face **Build Small Hackathon** (Backyard AI track). Runs as a **Gradio Space** with a custom frontend.
+**An AI founder pressure arena where student builders practice startup pitches, survive judge-style questions, enter a deal round, and leave with a scorecard that shows exactly what to fix.**
 
-## Features
+**Try it:** [Live Space](YOUR_SPACE_LINK_HERE) · [Demo Video](YOUR_DEMO_VIDEO_LINK_HERE) · [Hugging Face Blog](YOUR_HF_BLOG_LINK_HERE) · [GitHub](YOUR_GITHUB_LINK_HERE)
 
-- Multi-round pitch battles against different judge personas
-- Voice pitch and voice answers (Nemotron Omni)
-- Deal negotiation round after the pitch
-- Scorecard with coaching and retry on your weakest answer
+<a href="YOUR_SPACE_LINK_HERE">
+  <img src="https://raw.githubusercontent.com/prakhar811/PitchFight/main/assets/pitchfight-landing.png" alt="PitchFight AI landing page" width="900"/>
+</a>
 
-## How It Works
+**⚔️ Click the arena above to try PitchFight AI.**
 
+</div>
+
+---
+
+## TL;DR for Judges
+
+- **Backyard AI:** PitchFight AI helps student founders practice before hackathons, demo days, mentor reviews, and pitch rooms.
+- **NVIDIA Nemotron Quest:** The judge reasoning is powered by NVIDIA Nemotron through the backend API.
+- **Off Brand:** The app uses a custom cinematic frontend instead of default Gradio components.
+- **Best Demo:** The submission includes a live Space, demo video, and Hugging Face Blog write-up.
+- **Field Notes:** `FIELD_NOTES.md` and the Hugging Face Blog explain the product idea, build decisions, and technical approach.
+- **Community Choice:** The public Space is available for users to try and upvote.
+- **Judges' Wildcard:** PitchFight AI combines founder tooling, coaching, voice, and pressure simulation in one focused demo.
+
+---
+
+## Why this exists
+
+Most student founders do not lose because their idea is bad.
+
+They lose because the first hard question comes too late.
+
+> "What is your moat?"  
+> "Who exactly pays?"  
+> "Why now?"  
+> "What happens if a bigger player copies this?"
+
+PitchFight AI gives student builders a private practice room before the real room. It turns pitch practice into a pressure battle so founders can sharpen their story, defend their idea, and build confidence before facing real judges.
+
+---
+
+## What you can do
+
+- **Enter your startup idea.** Start with a raw pitch or load a demo founder.
+- **Get a founder briefing.** The system structures your idea into problem, solution, users, traction, competitors, and ask.
+- **Choose your opponent.** Face a Skeptical VC, Technical Judge, or Hackathon Judge.
+- **Pick the pressure level.** Practice Mode, Judge Mode, and Investor Mode change the intensity.
+- **Survive pitch rounds.** Answer realistic follow-up questions based on your pitch.
+- **Use voice mode.** Practice pitching and answering out loud.
+- **Enter the deal phase.** Defend your ask in a negotiation-style pressure round.
+- **Get a scorecard.** See what landed, what broke, and what to improve next.
+
+---
+
+## Demo
+
+**Watch the demo:** [YOUR_DEMO_VIDEO_LINK_HERE](YOUR_DEMO_VIDEO_LINK_HERE)
+
+<a href="YOUR_DEMO_VIDEO_LINK_HERE">
+  <img src="https://raw.githubusercontent.com/prakhar811/PitchFight/main/assets/pitchfight-battle.png" alt="PitchFight AI battle mode" width="900"/>
+</a>
+
+**Live Space:** [YOUR_SPACE_LINK_HERE](YOUR_SPACE_LINK_HERE)  
+**Build write-up:** [YOUR_HF_BLOG_LINK_HERE](YOUR_HF_BLOG_LINK_HERE)
+
+---
+
+## How it is built
+
+PitchFight AI runs as a Hugging Face Gradio Space, but the user experience is built as a custom frontend rather than a default Gradio interface.
+
+The frontend talks to backend routes in `app.py`. The backend handles pitch structuring, judge personas, battle state, voice mode, deal rounds, and scorecard generation. NVIDIA Nemotron is used as the core reasoning model for the AI judge.
+
+```mermaid
+flowchart LR
+    founder[Student Founder] --> ui[Custom PitchFight Frontend]
+    ui --> api[Gradio Backend / app.py]
+    api --> router[Model Router]
+    router --> nemotron[NVIDIA Nemotron API]
+    nemotron --> judge[Judge Questions + Feedback]
+    judge --> ui
+    api --> scorecard[Scorecard + Coaching]
+    scorecard --> ui
 ```
-Browser (custom frontend)
-    │  fetch → /api/*
-    ▼
-Gradio Server (app.py)
-    │  model_router → nvidia_client
-    ▼
-NVIDIA Nemotron API  (integrate.api.nvidia.com)
+
+---
+
+## System flow
+
+1. The founder submits or records a startup pitch.
+2. The backend structures the pitch into a founder briefing.
+3. The founder chooses an opponent and difficulty mode.
+4. The AI judge asks multi-round follow-up questions.
+5. The founder answers under pressure.
+6. The system evaluates clarity, confidence, defensibility, and traction.
+7. The founder enters a deal-style round.
+8. The final scorecard highlights strengths, weak points, and retry suggestions.
+
+---
+
+## Tech stack
+
+| Layer                | Technology                          |
+| -------------------- | ----------------------------------- |
+| Hosting              | Hugging Face Spaces                 |
+| Runtime              | Gradio                              |
+| Backend              | Python, `app.py`, custom API routes |
+| Frontend             | Custom HTML, CSS, JavaScript        |
+| AI Judge             | NVIDIA Nemotron                     |
+| Voice Support        | Nemotron Omni / voice pipeline      |
+| Audio Support        | ffmpeg                              |
+| Optional Persistence | MongoDB                             |
+| Deployment Secrets   | Hugging Face Space Secrets          |
+
+---
+
+## NVIDIA usage
+
+PitchFight AI uses NVIDIA Nemotron as the core judge and reasoning model.
+
+The backend calls the NVIDIA API through:
+
+```text
+https://integrate.api.nvidia.com/v1
 ```
 
-## Deploy on Hugging Face
+Primary model:
 
-1. Push this repo to a Gradio Space (the YAML frontmatter above configures it automatically).
-2. Add **`NVIDIA_API_KEY`** under **Settings → Repository secrets**.
-3. Build should pick up `packages.txt` (`ffmpeg`) for voice support.
+```text
+nvidia/nemotron-3-nano-omni-30b-a3b-reasoning
+```
 
-Optional secrets: `MAX_ROUNDS`, `ENABLE_VOICE_MODE`, `ENABLE_DEAL_BATTLE`, `MONGODB_URI` (only if you enable MongoDB).
+The model is used for:
 
-Never put API keys in the frontend or in git.
+- founder brief structuring
+- judge persona reasoning
+- pitch battle follow-up questions
+- deal round pressure
+- final scorecard feedback
 
-## Run Locally
+`NVIDIA_API_KEY` is stored only as a backend secret and is never exposed to frontend JavaScript.
+
+---
+
+## Built for the Build Small Hackathon
+
+PitchFight AI was built for the Hugging Face **Build Small Hackathon**.
+
+The goal was to create a focused AI product that feels genuinely useful through structured reasoning, judge personas, voice interaction, and a polished custom interface.
+
+| Prize / Badge             | Status    | Why PitchFight AI qualifies                                                       |
+| ------------------------- | --------- | --------------------------------------------------------------------------------- |
+| **Backyard AI**           | Submitted | Helps student founders practice for real-world pitch situations.                  |
+| **NVIDIA Nemotron Quest** | Submitted | Uses NVIDIA Nemotron as the core reasoning model.                                 |
+| **Off Brand**             | Submitted | Fully custom cinematic frontend, not default Gradio UI.                           |
+| **Best Demo**             | Submitted | Live Space, demo video, and blog write-up are linked.                             |
+| **Field Notes**           | Submitted | Hugging Face Blog and `FIELD_NOTES.md` explain the idea, build, and tech.         |
+| **Community Choice**      | Eligible  | Public Space is available for users to try and upvote.                            |
+| **Judges' Wildcard**      | Eligible  | PitchFight AI combines founder tooling, coaching, voice, and pressure simulation. |
+
+### Not claiming
+
+- **OpenBMB / MiniCPM:** PitchFight AI uses NVIDIA Nemotron, not MiniCPM.
+- **Modal:** Not claimed unless Modal is used in development or runtime.
+- **Tiny Titan:** Not claimed because the primary model is not ≤4B.
+- **Off the Grid:** Not claimed because the app uses the NVIDIA hosted API.
+- **Fine-tuning:** Not claimed. Inference uses the hosted Nemotron API only.
+
+---
+
+## Submission links
+
+| Item              | Link                               |
+| ----------------- | ---------------------------------- |
+| Live Space        | YOUR_SPACE_LINK_HERE               |
+| Demo Video        | YOUR_DEMO_VIDEO_LINK_HERE          |
+| Hugging Face Blog | YOUR_HF_BLOG_LINK_HERE             |
+| GitHub Repository | YOUR_GITHUB_LINK_HERE              |
+| Field Notes       | [`FIELD_NOTES.md`](FIELD_NOTES.md) |
+
+---
+
+## Hugging Face deployment
+
+Required Space secret:
+
+```bash
+NVIDIA_API_KEY=
+```
+
+Optional variables:
+
+```bash
+APP_ENV=production
+MAX_ROUNDS=6
+DEFAULT_MODEL_MODE=premium_nvidia
+NVIDIA_BASE_URL=https://integrate.api.nvidia.com/v1
+NVIDIA_OMNI_MODEL=nvidia/nemotron-3-nano-omni-30b-a3b-reasoning
+ENABLE_DECK_CRITIQUE=true
+ENABLE_DEAL_BATTLE=true
+ENABLE_VOICE_MODE=true
+MONGODB_URI=
+```
+
+Never put API keys in frontend code or commit real secrets to GitHub.
+
+---
+
+## Run locally
 
 ```bash
 python -m venv venv
-.\venv\Scripts\Activate.ps1          # Windows
+.\venv\Scripts\Activate.ps1
 pip install -r requirements.txt
-cp .env.example .env                 # add NVIDIA_API_KEY
+cp .env.example .env
 python app.py
 ```
 
-Open `http://127.0.0.1:7860`. Install `ffmpeg` locally if you use voice mode.
+Open:
+
+```bash
+http://127.0.0.1:7860
+```
+
+Install `ffmpeg` locally if using voice mode.
+
+---
+
+## Project structure
+
+```text
+.
+├── app.py                 Gradio app entrypoint and backend routes
+├── requirements.txt       Python dependencies
+├── packages.txt           System packages such as ffmpeg
+├── .env.example           Local environment variable template
+├── assets/                Screenshots for README and submission
+├── frontend/              Custom HTML, CSS, JS, and UI assets
+├── core/                  Backend handlers, model router, clients
+├── FIELD_NOTES.md         Build notes for the Field Notes badge
+└── README.md              Space card and hackathon submission write-up
+```
+
+---
+
+## Safety note
+
+PitchFight AI is a practice and coaching tool. It does not replace real mentors, investors, or legal/financial advisors. It is designed to help founders sharpen their pitch before entering the real room.
+
+---
+
+<div align="center">
 
-## Stack
+**If your pitch can survive the arena, it has a better chance in the room.**
 
-| Piece | Detail |
-|-------|--------|
-| Host | Gradio Server (`app.py`) on Hugging Face Spaces |
-| Model | NVIDIA Nemotron 3 Nano Omni 30B-A3B (backend API) |
-| UI | Custom HTML/CSS/JS — not default Gradio widgets |
+</div>

frontend/script.js

@@ -78,8 +78,28 @@ function showScreen(name) {
   const app = document.getElementById("app");
   app?.classList.toggle("app-arena-fullwidth", name === "battle" || name === "deal" || name === "scorecard" || name === "dealScorecard");
   app?.classList.toggle("app-scorecard-fullwidth", name === "scorecard");
-  if (name === "landing" && landingIntroComplete) {
-    finalizeLandingIntroStatic();
+  if (name === "landing") {
+    syncLandingViewport();
+    if (landingIntroComplete) {
+      finalizeLandingIntroStatic();
+    }
+  }
+}
+
+/* ---- Landing viewport sync (HF Spaces iframe-safe) ---- */
+
+function syncLandingViewport() {
+  const vh = window.innerHeight;
+  if (!vh) return;
+  document.documentElement.style.setProperty("--landing-vh", `${vh}px`);
+}
+
+function initLandingViewport() {
+  syncLandingViewport();
+  window.addEventListener("resize", syncLandingViewport, { passive: true });
+  window.addEventListener("orientationchange", syncLandingViewport, { passive: true });
+  if (window.visualViewport) {
+    window.visualViewport.addEventListener("resize", syncLandingViewport, { passive: true });
   }
 }
 
@@ -3013,6 +3033,7 @@ function boot() {
   hideErrorBanner();
   setBriefingMode("quick");
   initBriefPreviewEditors();
+  initLandingViewport();
   initLandingIntro();
   initScorecardTabs();
 

frontend/styles.css

@@ -20,6 +20,11 @@
   --gold: var(--accent-gold);
   --border: var(--border-soft);
   --shadow: 0 12px 40px rgba(0, 0, 0, 0.55);
+
+  /* Landing — HF-safe viewport (JS sets --landing-vh from innerHeight) */
+  --landing-vh: 100svh;
+  --landing-safe-pad-y: clamp(12px, 2vh, 28px);
+  --landing-safe-pad-x: clamp(12px, 2vw, 24px);
 }
 
 * {
@@ -29,22 +34,44 @@
 html {
   width: 100%;
   max-width: 100%;
+  height: 100%;
+  margin: 0;
+  padding: 0;
   overflow-x: hidden;
 }
 
 body {
   margin: 0;
-  min-height: 100vh;
+  padding: 0;
+  min-height: 100%;
   width: 100%;
   max-width: 100%;
   overflow-x: hidden;
   font-family: "Segoe UI", system-ui, sans-serif;
   color: var(--text);
-  background: #09090f;
+  background: var(--bg-deep);
   font-size: 14px;
   line-height: 1.5;
 }
 
+html:has(#screen-landing.active) {
+  height: var(--landing-vh, 100svh);
+  height: var(--landing-vh, 100dvh);
+  overflow: hidden;
+}
+
+body:has(#screen-landing.active) {
+  overflow: hidden;
+  min-height: var(--landing-vh, 100svh);
+  min-height: var(--landing-vh, 100dvh);
+  height: var(--landing-vh, 100svh);
+  height: var(--landing-vh, 100dvh);
+}
+
+body:has(#screen-setup.active) {
+  overflow: hidden;
+}
+
 .bg-glow {
   position: fixed;
   inset: 0;
@@ -64,10 +91,29 @@ body {
 
 .app:has(#screen-battle.active),
 .app:has(#screen-deal.active),
+.app:has(#screen-landing.active),
+.app:has(#screen-setup.active),
 .app.app-arena-fullwidth:not(.app-scorecard-fullwidth) {
   max-width: none !important;
   width: 100% !important;
   padding: 0 !important;
+  margin: 0 !important;
+}
+
+.app:has(#screen-landing.active) {
+  display: flex;
+  flex-direction: column;
+  min-height: var(--landing-vh, 100svh);
+  min-height: var(--landing-vh, 100dvh);
+  height: var(--landing-vh, 100svh);
+  height: var(--landing-vh, 100dvh);
+  max-height: var(--landing-vh, 100svh);
+  max-height: var(--landing-vh, 100dvh);
+  overflow: hidden;
+}
+
+.app:has(#screen-setup.active) {
+  min-height: calc(100dvh - 56px);
 }
 
 .screen {
@@ -127,20 +173,27 @@ h1 {
    ================================ */
 
 #screen-landing.active {
-  display: block;
+  display: flex;
+  flex-direction: column;
+  flex: 1 1 auto;
+  width: 100%;
+  min-height: 100%;
+  overflow: hidden;
 }
 
 .arena-landing {
   position: relative;
-  width: 100vw;
-  min-height: auto;
-  padding: clamp(0.5rem, 1.5vh, 1rem) 0;
-  margin-left: calc(50% - 50vw);
-  margin-right: calc(50% - 50vw);
+  width: 100%;
+  flex: 1 1 auto;
+  min-height: 100%;
+  box-sizing: border-box;
+  padding: var(--landing-safe-pad-y) var(--landing-safe-pad-x);
+  margin: 0;
   overflow: hidden;
   display: flex;
   align-items: center;
   justify-content: center;
+  background: var(--bg-deep);
 }
 
 /* ---- Landing Scene Layers (Pass 1.5) ---- */
@@ -747,9 +800,12 @@ h1 {
   position: relative;
   z-index: 2;
   text-align: center;
-  padding: clamp(1rem, 3vw, 1.75rem) clamp(0.85rem, 2.5vw, 1.25rem) clamp(1rem, 2.5vw, 1.5rem);
-  max-width: 820px;
   width: 100%;
+  max-width: 820px;
+  max-height: 100%;
+  padding: clamp(0.5rem, 1.5vh, 1rem) clamp(0.85rem, 2.5vw, 1.25rem);
+  transform-origin: center center;
+  overflow: hidden;
 }
 
 .arena-eyebrow {
@@ -995,11 +1051,13 @@ h1 {
   50% { background-position: 0 100%; }
 }
 
-@media (max-width: 640px) {
-  .arena-landing {
-    min-height: calc(100vh - 1rem);
+@media (max-height: 860px) {
+  .arena-landing-content {
+    transform: scale(0.96);
   }
+}
 
+@media (max-width: 640px) {
   .founder-silhouette,
   .judge-silhouette {
     opacity: 0.65;
@@ -1135,6 +1193,10 @@ h1 {
   .arena-feature-chips.visible {
     opacity: 1 !important;
   }
+
+  .arena-landing-content {
+    transform: none !important;
+  }
 }
 
 .btn {
@@ -2861,30 +2923,48 @@ body.rounds-drawer-open {
   margin: 0 auto;
 }
 
-.app:has(#screen-scorecard.active),
-.app.app-scorecard-fullwidth {
-  max-width: none !important;
-  width: 100% !important;
-  padding: clamp(0.5rem, 1.2vw, 0.85rem) !important;
+#screen-setup.active {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  box-sizing: border-box;
+  width: 100%;
+  min-height: calc(100dvh - 56px);
+  max-height: calc(100dvh - 56px);
+  overflow-x: hidden;
+  overflow-y: auto;
+  padding:
+    clamp(1rem, 2vh, 1.75rem)
+    clamp(1rem, 2.5vw, 1.75rem)
+    clamp(2.5rem, 6vh, 4.5rem);
 }
 
 #screen-setup.active .briefing-shell-wide {
-  width: min(1180px, 92vw);
-  max-width: 100%;
+  width: 100%;
+  max-width: min(1400px, calc(100vw - 2.5rem));
   margin: 0 auto;
-  padding-bottom: 0.5rem;
+  padding: 0;
+  transform: translateY(clamp(-4px, -0.75vh, -10px));
 }
 
 .briefing-shell-wide {
-  max-width: min(1180px, 92vw);
+  max-width: min(1400px, calc(100vw - 2.5rem));
   width: 100%;
   margin: 0 auto;
 }
 
+.app:has(#screen-scorecard.active),
+.app.app-scorecard-fullwidth {
+  max-width: none !important;
+  width: 100% !important;
+  padding: clamp(0.5rem, 1.2vw, 0.85rem) !important;
+}
+
 .briefing-mode-tabs {
   display: flex;
   gap: 0.45rem;
-  margin-bottom: 0.75rem;
+  margin-bottom: clamp(0.9rem, 1.8vh, 1.2rem);
   flex-wrap: wrap;
 }
 
@@ -2916,15 +2996,15 @@ body.rounds-drawer-open {
 }
 
 .briefing-grid-wide {
-  grid-template-columns: minmax(0, 1.12fr) minmax(280px, 0.88fr);
-  gap: 0.85rem;
+  grid-template-columns: minmax(0, 1.12fr) minmax(300px, 0.88fr);
+  gap: clamp(0.85rem, 1.6vw, 1.1rem);
   align-items: stretch;
 }
 
 .briefing-left-col {
-  display: grid;
-  grid-template-columns: minmax(0, 1fr);
-  align-items: stretch;
+  display: flex;
+  flex-direction: column;
+  min-height: 100%;
   min-width: 0;
   overflow: visible;
 }
@@ -2933,6 +3013,13 @@ body.rounds-drawer-open {
   min-height: 0;
 }
 
+.briefing-left-col > .panel:not([hidden]) {
+  flex: 1 1 auto;
+  display: flex;
+  flex-direction: column;
+  min-height: 100%;
+}
+
 .briefing-left-col.mode-advanced .quick-pitch-panel,
 .briefing-left-col.mode-advanced .brief-preview-panel {
   display: none !important;
@@ -2948,7 +3035,10 @@ body.rounds-drawer-open {
 }
 
 .quick-pitch-panel {
+  display: flex;
+  flex-direction: column;
   padding: clamp(0.75rem, 1.8vw, 0.95rem) clamp(0.85rem, 1.8vw, 1rem);
+  min-height: 100%;
 }
 
 .quick-pitch-label {
@@ -2962,8 +3052,9 @@ body.rounds-drawer-open {
 
 .quick-pitch-textarea {
   width: 100%;
+  flex: 1 1 auto;
   min-height: clamp(96px, 14vh, 128px);
-  max-height: clamp(120px, 18vh, 150px);
+  max-height: clamp(140px, 22vh, 190px);
   padding: 0.7rem 0.85rem;
   border-radius: 12px;
   border: 1px solid rgba(255, 255, 255, 0.12);
@@ -2991,7 +3082,8 @@ body.rounds-drawer-open {
   display: flex;
   flex-direction: column;
   gap: 0.55rem;
-  margin-top: 0.75rem;
+  margin-top: auto;
+  padding-top: 0.85rem;
 }
 
 .quick-pitch-actions .btn-wide {
@@ -3313,64 +3405,66 @@ body.rounds-drawer-open {
 
 .briefing-opponent-panel .briefing-section-title,
 .briefing-opponent-panel .difficulty-selector h3 {
-  margin: 0 0 0.4rem;
+  margin: 0 0 0.5rem;
   font-size: 0.82rem;
   letter-spacing: 0.08em;
 }
 
 .briefing-opponent-panel .persona-grid {
   grid-template-columns: repeat(3, minmax(0, 1fr));
-  gap: 0.45rem;
-  margin-top: 0.35rem;
+  gap: 0.55rem;
+  margin-top: 0.45rem;
 }
 
 .briefing-opponent-panel .difficulty-grid {
   grid-template-columns: repeat(3, minmax(0, 1fr));
-  gap: 0.45rem;
+  gap: 0.55rem;
 }
 
-.briefing-opponent-panel .persona-card {
-  padding: 0.5rem 0.55rem;
+.briefing-opponent-panel .persona-card,
+.briefing-opponent-panel .difficulty-card {
+  display: flex;
+  flex-direction: column;
+  justify-content: flex-start;
+  min-height: clamp(78px, 10.5vh, 94px);
+  padding: clamp(0.62rem, 1.1vh, 0.74rem) clamp(0.58rem, 1vw, 0.68rem);
   border-radius: 10px;
 }
 
 .briefing-opponent-panel .persona-card .persona-icon {
-  font-size: 1rem;
+  font-size: 1.15rem;
   line-height: 1;
+  display: block;
+  margin-bottom: 0.24rem;
 }
 
 .briefing-opponent-panel .persona-card h3 {
-  margin: 0.25rem 0 0.15rem;
+  margin: 0.32rem 0 0.2rem;
   font-size: 0.8rem;
 }
 
 .briefing-opponent-panel .persona-card p {
   font-size: 0.68rem;
-  line-height: 1.25;
+  line-height: 1.3;
 }
 
 .briefing-opponent-panel .difficulty-selector {
-  margin-top: 0.65rem;
-}
-
-.briefing-opponent-panel .difficulty-card {
-  padding: 0.5rem 0.55rem;
-  border-radius: 10px;
+  margin-top: clamp(0.85rem, 1.8vh, 1.15rem);
 }
 
 .briefing-opponent-panel .difficulty-card .difficulty-icon {
-  font-size: 1rem;
-  margin-bottom: 0.15rem;
+  font-size: 1.15rem;
+  margin-bottom: 0.24rem;
 }
 
 .briefing-opponent-panel .difficulty-card h4 {
-  margin: 0 0 0.1rem;
+  margin: 0 0 0.18rem;
   font-size: 0.78rem;
 }
 
 .briefing-opponent-panel .difficulty-card p {
   font-size: 0.66rem;
-  line-height: 1.2;
+  line-height: 1.28;
 }
 
 .briefing-opponent-note {
@@ -3387,13 +3481,13 @@ body.rounds-drawer-open {
   align-self: stretch;
   min-height: 100%;
   height: 100%;
-  gap: 0;
+  gap: clamp(0.45rem, 0.9vh, 0.65rem);
   padding: clamp(0.7rem, 1.6vw, 0.85rem) clamp(0.8rem, 1.8vw, 0.95rem);
 }
 
 .briefing-opponent-footer {
   margin-top: auto;
-  padding-top: 1rem;
+  padding-top: clamp(0.65rem, 1.2vh, 0.85rem);
   display: flex;
   flex-direction: column;
   gap: 0.55rem;
@@ -3412,7 +3506,14 @@ body.rounds-drawer-open {
   justify-content: space-between;
   align-items: flex-start;
   gap: 1rem;
-  margin-bottom: 0.75rem;
+  width: 100%;
+  margin-bottom: clamp(1rem, 2vh, 1.35rem);
+}
+
+.briefing-header .btn-ghost {
+  flex-shrink: 0;
+  align-self: flex-start;
+  margin-top: 0.15rem;
 }
 
 .briefing-title {
@@ -8672,14 +8773,20 @@ blockquote.sc-answer-text {
 }
 
 @media (max-height: 760px) {
-  .arena-landing {
-    min-height: auto;
-    padding: 0.5rem 0;
+  .arena-landing-content {
+    padding-top: 0.5rem;
+    padding-bottom: 0.5rem;
+    transform: scale(0.9);
   }
 
-  .arena-landing-content {
-    padding-top: 0.75rem;
-    padding-bottom: 0.75rem;
+  #screen-setup.active {
+    justify-content: flex-start;
+    padding-top: 0.85rem;
+    padding-bottom: 1.25rem;
+  }
+
+  #screen-setup.active .briefing-shell-wide {
+    transform: none;
   }
 
   .founder-silhouette,
@@ -8717,7 +8824,8 @@ blockquote.sc-answer-text {
 
   .briefing-opponent-panel .persona-card,
   .briefing-opponent-panel .difficulty-card {
-    padding: 0.45rem 0.5rem;
+    padding: clamp(0.52rem, 0.95vh, 0.62rem) clamp(0.5rem, 0.9vw, 0.58rem);
+    min-height: clamp(68px, 9vh, 78px);
   }
 
   .persona-card,