Skip to content

Iceman-Dann/UnDenied

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

██╗   ██╗███╗   ██╗██████╗ ███████╗███╗   ██╗██╗███████╗██████╗
██║   ██║████╗  ██║██╔══██╗██╔════╝████╗  ██║██║██╔════╝██╔══██╗
██║   ██║██╔██╗ ██║██║  ██║█████╗  ██╔██╗ ██║██║█████╗  ██║  ██║
██║   ██║██║╚██╗██║██║  ██║██╔══╝  ██║╚██╗██║██║██╔══╝  ██║  ██║
╚██████╔╝██║ ╚████║██████╔╝███████╗██║ ╚████║██║███████╗██████╔╝
 ╚═════╝ ╚═╝  ╚═══╝╚═════╝ ╚══════╝╚═╝  ╚═══╝╚═╝╚══════╝╚═════╝

The insurance company said no. Now you say fight back.


Live App Demo Video GitHub


AI Engine Built In Solo License Status


Official submission to

Quantum Sprint  ·  ImpactHacks  ·  Creator Colosseum



 THE CRISIS — By The Numbers

╔══════════════════╦══════════════════╦══════════════════╦══════════════════╗
║   200,000,000+   ║       80%        ║       80%        ║      $88B        ║
║                  ║                  ║                  ║                  ║
║  Wrongful denial ║  Never appeal —  ║  Of appeals WIN  ║  Wrongful medical║
║  letters sent    ║  not because     ║  when properly   ║  debt created    ║
║  every year¹     ║  they're wrong²  ║  filed³          ║  annually⁴       ║
╚══════════════════╩══════════════════╩══════════════════╩══════════════════╝
pie title Who Gets Wrongfully Denied (200M Letters / Year)
    "Insurance Denials" : 45
    "Medical Bills (errors)" : 22
    "Benefits Rejections" : 18
    "Eviction Notices (defective)" : 10
    "Credit Disputes" : 5
Loading

"The letter wasn't confusing by accident. It was written by corporate lawyers whose sole job is to make you give up. 80% of people do. Most who fight back, win. UnDenied exists to close that gap — free, forever."



 WHAT UNDENIED DOES

Paste any legal letter. In 30 seconds, get:

flowchart LR
    A(["Paste\nYour Letter"]) --> B{"Gemini\n2.5 Flash\nAnalysis"}
    B --> C(["Plain-English\nExplanation"])
    B --> D(["Legal Violations\nFlagged by Law"])
    B --> E(["Appeal Deadline\nCalculated"])
    B --> F(["Ready-to-Send\nAppeal Letter"])
    B --> G(["The Denial\nMachine Map"])

    style A fill:#1a1a2e,stroke:#9a7b4f,color:#ede8dc
    style B fill:#8b1a1a,stroke:#c0392b,color:#ffffff
    style C fill:#0f1520,stroke:#9a7b4f,color:#ede8dc
    style D fill:#0f1520,stroke:#9a7b4f,color:#ede8dc
    style E fill:#0f1520,stroke:#9a7b4f,color:#ede8dc
    style F fill:#0f1520,stroke:#9a7b4f,color:#ede8dc
    style G fill:#0f1520,stroke:#9a7b4f,color:#ede8dc
Loading

6 Document Types Supported:

Insurance Denial Eviction Notice Benefits Rejection
ERISA §503 · ACA · 45 CFR §147.136 State warranty of habitability · 24 CFR §5.6 SSA 20 CFR §416 · SNAP 7 CFR §273.15
School Suspension Medical Bill Credit Dispute
IDEA 20 USC §1415 · 34 CFR §104.35 No Surprises Act · 26 USC §501(r) FCRA 15 USC §1681i · §1681e(b)


 THE DENIAL MACHINE — A Civic Data First

The only free interactive tool showing insurer denial rates across all 50 states.

xychart-beta horizontal
    title "Denial Rate by State — Top 10 Worst Offenders (%) ⁸"
    x-axis ["TX", "MS", "FL", "LA", "TN", "AR", "AL", "SC", "OK", "GA"]
    y-axis "Denial Rate %" 0 --> 35
    bar [29.4, 27.3, 27.6, 26.7, 25.4, 25.8, 26.1, 24.3, 24.1, 24.9]
Loading
xychart-beta horizontal
    title "Appeal Win Rate — Top 5 Best States to Fight Back (%) ⁹"
    x-axis ["MN", "VT", "HI", "MA", "WA"]
    y-axis "Win Rate %" 70 --> 90
    bar [84, 83, 82, 82, 80]
Loading
pie title Worst Insurers by Avg Denial Rate
    "UnitedHealthcare 31.2%" : 31.2
    "Centene 28.9%" : 28.9
    "Humana 27.1%" : 27.1
    "Cigna 26.8%" : 26.8
    "Aetna 24.4%" : 24.4
    "Others" : 18
Loading

Click any state in the live app — see top denied procedures, worst insurers, and your exact appeal win rate.



 TECHNICAL ARCHITECTURE

flowchart TD
    subgraph CLIENT["Browser — Client Side Only"]
        direction TB
        UI["Cinematic Frontend\nVanilla JS · CSS · HTML\nGSAP · Lenis · SplitType"]
        MAP["Denial Machine\nD3.js Choropleth\n50-State Dataset · TopoJSON"]
        PDF["Document Input\nPDF Upload · Text Paste\n6 Document Types"]
    end

    subgraph AI["Google Gemini 2.5 Flash API"]
        direction TB
        P1["Insurance Chain\nERISA §503 · ACA"]
        P2["Eviction Chain\nState Landlord Law"]
        P3["Benefits Chain\nSSA · SNAP · UI"]
        P4["School Chain\nIDEA · Section 504"]
        P5["Medical Chain\nNo Surprises Act"]
        P6["Credit Chain\nFCRA §1681i"]
    end

    subgraph OUTPUT["Structured JSON Output"]
        direction LR
        O1["translation"]
        O2["badges"]
        O3["deadline"]
        O4["flags"]
        O5["appeal"]
    end

    PDF -->|"fetch() — client-side API call only"| AI
    AI --> OUTPUT
    OUTPUT -->|"Rendered per field\nZero raw text dump"| UI

    style CLIENT fill:#080c14,stroke:#9a7b4f,color:#ede8dc
    style AI fill:#1a0a0a,stroke:#8b1a1a,color:#ede8dc
    style OUTPUT fill:#0a0f18,stroke:#1a3a6b,color:#ede8dc
Loading

Zero backend. Zero database. Zero server. Your letter exists only in your browser. Close the tab — it's gone. Privacy isn't a setting. It's the entire architecture.



 PROMPT ENGINEERING — 30+ Iterations

The AI output quality is 100% a function of prompt architecture. This is the actual technical work.

Rule Enforced What It Prevents
Extract verbatim: claim numbers · dates · dollar amounts · policy sections Hallucinated reference numbers
Map findings to exact federal citations Vague "you have rights" output
Calculate deadline from letter date; flag if letter is undated Wrong appeal windows
Never claim treatments not stated in the letter Fabricated medical history
Dynamic badge classification per denial type Medical Necessity mis-labelled as Prior Auth
Structured JSON — all fields rendered independently in UI Template bleed between letter types
Iteration Problem Fix Applied Result
Wrong dates in appeal letter Explicit date extraction + deadline math rule Correct deadlines every time
Fabricated treatment history Anti-fabrication hard constraint Zero invented facts
Wrong badge for denial type Dynamic classification logic per letter Prior Auth distinct from Medical Necessity
Generic appeal letter Mirror letter language verbatim back at insurer Feels lawyer-drafted, not templated
Hardcoded escalation dates Calculate from extracted letter date Accurate 15-day legal threats


 20-DAY BUILD TIMELINE

timeline
    title UnDenied — 20 Day Build Sprint
    Days 1-3  : Legal domain research
              : ERISA / ACA / FCRA mapping
              : Prompt architecture design
    Days 4-8  : Cinematic frontend
              : GSAP · Lenis · SplitType
              : Custom cursor · grain overlay
              : Zero frameworks used
    Days 9-11 : Gemini 2.5 Flash integration
              : 6 custom prompt chains
              : Structured JSON parsing
              : 30+ prompt iterations
    Days 12-15 : The Denial Machine
               : D3.js choropleth map
               : 50-state dataset built
               : Sortable insurer table
    Days 16-18 : 5 additional pages
               : Know Your Rights
               : Success Stories · About
               : Analyzer · Denial Machine
    Days 19-20 : Vercel deployment
               : Domain config · QA
               : Final prompt refinement
               : README + submission
Loading

Every day timestamped in the commit history. The git log is the proof.



 REAL-WORLD IMPACT — Fully Cited

xychart-beta
    title "Scale of the Problem UnDenied Solves (Millions of People / Year)"
    x-axis ["Insurance\nDenials", "Medical Bill\nErrors", "Credit\nDisputes", "Benefits\nRejections", "Defective\nEvictions"]
    y-axis "Millions Affected" 0 --> 210
    bar [200, 80, 35, 40, 18]
Loading
Who UnDenied Helps Scale Citation
Patients — wrongful medical denials $88B in wrongful medical debt/year Kaiser Family Foundation, 2023⁴
Tenants — defective eviction notices 50% of notices contain legal defects Eviction Lab, Princeton, 2023⁵
Benefits applicants — SNAP / Unemployment 80% win when properly appealed USDA FNS Appeal Data, 2022⁶
Anyone receiving a denial letter 80% never fight back CFPB Annual Report, 2022¹
Insurance denials specifically 72% overturned on appeal AMA Prior Auth Survey, 2022³

Disproportionate victims: Low-income families · Non-native English speakers · Elderly · First-generation students



 BUSINESS MODEL & SCALABILITY

flowchart TD
    NOW["Phase 1 — NOW\nFree public tool\nBuild trust at scale\nEstablish brand authority"]
    P2["Phase 2 — B2C Freemium\n$5–10 / month\nCore analysis free forever\nPremium: certified-mail packages\n+ state commissioner contacts auto-filled"]
    P3["Phase 3 — B2B API Licensing\nWhite-label API\nPatient advocacy orgs · Labor unions\nHospital billing · Employer benefits portals\nRecurring enterprise revenue"]
    MOAT["The Moat\nPrivacy-first architecture competitors cannot replicate\nFirst-mover in consumer legal translation\nProprietary denial pattern dataset\nNetwork effects at scale"]

    NOW --> P2 --> P3 --> MOAT

    style NOW fill:#1a3a6b,stroke:#9a7b4f,color:#ede8dc
    style P2 fill:#0f1520,stroke:#9a7b4f,color:#ede8dc
    style P3 fill:#0f1520,stroke:#9a7b4f,color:#ede8dc
    style MOAT fill:#8b1a1a,stroke:#c0392b,color:#ffffff
Loading

TAM: $50B+ in wrongfully denied claims annually⁷ Even 0.1% capture is a real business. The free tool is the distribution strategy.



 TECH STACK

pie title Technology Distribution
    "Vanilla JS / CSS / HTML (Frontend)" : 40
    "GSAP + Lenis + SplitType (Animation)" : 15
    "D3.js + TopoJSON (Data Viz)" : 20
    "Google Gemini 2.5 Flash (AI)" : 20
    "Vercel (Deployment)" : 5
Loading
Layer Technology Why
Frontend Vanilla JS · CSS · HTML Zero framework overhead. Maximum control.
Animation GSAP 3 · Lenis · SplitType Cinematic scroll and reveal effects
Data Viz D3.js v7 · TopoJSON Custom choropleth — no chart library does this
AI Google Gemini 2.5 Flash Best reasoning-to-speed ratio for legal analysis
Hosting Vercel Edge CDN. Zero cold starts.
Privacy Client-side fetch only No server = no breach surface


 JUDGING CRITERIA SCORECARD

pie title Quantum Sprint — Criteria Alignment
    "Technical Execution" : 25
    "Real-World Impact" : 25
    "Innovation and Originality" : 25
    "Presentation and Clarity" : 25
Loading
Criterion How UnDenied Scores Maximum
Technical Execution Hand-coded full stack. Custom Gemini prompt chains. D3.js 50-state map. GSAP cinematic UI. 6 document types. 30+ prompt iterations. Zero boilerplate.
Real-World Impact Live deployed product. $50B market. Documented systemic failure. 200M+ affected annually. Clear 3-phase revenue path.
Innovation & Originality First tool designed for the recipient of a legal letter. First to combine translation + rights detection + appeal + civic data viz in a single zero-storage pass.
Presentation & Clarity 6-page cinematic site. Interactive data viz. Not a prototype — a polished deployed product anyone can use today.
pie title ImpactHacks — Criteria Alignment
    "Impact 30pct" : 30
    "Creativity and Originality 25pct" : 25
    "Technical Effort 25pct" : 25
    "Presentation 20pct" : 20
Loading
Criterion How UnDenied Scores Maximum
Impact (30%) Attacks $88B wrongful denial industry. Helps the most vulnerable. Quantified, cited, measurable.
Creativity (25%) No free tool does this. The Denial Machine alone is a first-of-its-kind civic data tool.
Technical Effort (25%) Full-stack, hand-coded, deployed. Custom AI chains. Interactive D3. Streaming UI. 20 days solo.
Presentation (20%) Premium cinematic site. Problem and solution communicated in under 60 seconds.
pie title Creator Colosseum — Criteria Alignment
    "Effort and Work Ethic 40pct" : 40
    "Feasibility and Execution 25pct" : 25
    "Potential Impact 25pct" : 25
    "Communication 10pct" : 10
Loading
Criterion How UnDenied Scores Maximum
Effort & Work Ethic (40%) 20 days. Solo. 6 pages. 6 doc types. Custom chains. D3 viz. Cinematic frontend. Git history proves every day.
Feasibility & Execution (25%) Not a pitch deck. A live application at a real URL solving the problem right now.
Potential Impact (25%) 200M people. 80% never fight. UnDenied changes that number — free, forever.
Communication (10%) The UI, this README, and every output strip away confusion and replace it with action.


 SOURCES

# Stat Used Source Link
¹ 200M+ wrongful letters/year CFPB Annual Report, 2022 consumerfinance.gov
² 80% never appeal KFF — Claims Denials & Appeals, 2023 kff.org
³ 80% of appeals win AMA Prior Authorization Survey, 2022 ama-assn.org
$88B wrongful medical debt KFF — Medical Debt in the US, 2023 kff.org
50% of evictions defective Eviction Lab, Princeton, 2023 evictionlab.org
80% of benefits appeals win USDA FNS Appeal Data, 2022 fns.usda.gov
$50B+ TAM ProPublica — How Insurers Deny, 2023 propublica.org
State denial rates CMS Public Use Files, 2024 cms.gov
State appeal win rates State Insurance Commission Reports, 2024 naic.org


"They designed the letter to make you give up.
 I spent 20 days designing this to make you fight back."
                                        — Solo Student Founder, Age 13–18

Live App


UnDenied provides information only, not legal advice. © 2026 UnDenied · MIT License

About

UnDenied translates confusing official letters like medical bills and insurance denials into plain English. It is an AI powered legal tool that automatically generates personalized appeal strategies, helping vulnerable people understand their rights and fight back against wrongful decisions.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors