Upload README.md with huggingface_hub

README.md

@@ -1,6 +1,6 @@
 ---
-title: Dark Pattern NLP Triage & Deceptive UX Detector
-emoji: 🕵️
+title: Dark Pattern Detector
+emoji: 🛡️
 colorFrom: purple
 colorTo: red
 sdk: static
@@ -10,22 +10,32 @@ tags:
   - nlp
   - consumer-protection
   - distilbert
-  - ethics-in-ai
 ---
 
-# 🕵️ Dark Pattern NLP Triage & Deceptive UX Detector
+# Dark Pattern Detector 🛡️
 
-Interactive real-time NLP classification engine detecting deceptive UI/UX designs and coercive e-commerce patterns across 7 industry-standard taxonomies.
+An interactive NLP classification engine designed to detect deceptive UI copy, artificial scarcity, and manipulative e-commerce patterns.
 
-## 🎯 Supported Dark Pattern Taxonomies
-1. 🔴 **Urgency / Scarcity:** False inventory countdowns and artificial expiration timers.
-2. 🟡 **Misdirection:** Pre-selected add-ons and deceptive visual hierarchy.
-3. 🟣 **Social Proof:** Synthetic activity badges ("50 people looking right now").
-4. 🩷 **Forced Continuity:** Friction-heavy cancellation and disguised recurring renewals.
-5. 🟠 **Confirm-shaming:** Manipulative opt-out copy designed to guilt-trip users.
-6. 🩵 **Hidden Costs:** Undisclosed mandatory charges revealed only at final payment.
-7. 🔵 **Disguised Ads:** Sponsored placement camouflaged as organic editorial content.
+- **GitHub Repository**: [JayanGupta/Dark-Pattern-Detection](https://github.com/JayanGupta/Dark-Pattern-Detection)
+- **Author**: [Jayan Gupta](https://huggingface.co/Jayan12321)
 
-## 🔗 Project Provenance & Open Source
-* **GitHub Repository:** [JayanGupta/Dark-Pattern-Detection](https://github.com/JayanGupta/Dark-Pattern-Detection)
-* **Author:** [Jayan Gupta](https://huggingface.co/Jayan12321) (Data Scientist & AI Engineer)
+---
+
+## 🎯 What are Dark Patterns?
+Dark patterns are user interface designs crafted to trick users into doing things they might not otherwise do (e.g. buying unwanted add-ons, signing up for disguised recurring subscriptions, or agreeing to invasive tracking).
+
+---
+
+## 📋 Detected Taxonomies
+This tool identifies manipulative patterns across industry-standard taxonomies:
+1. **Urgency & Scarcity**: Artificial countdown timers and fake low-stock alerts.
+2. **Misdirection**: Using visual hierarchy or pre-checked checkboxes to steer users toward a specific choice.
+3. **Social Proof Exploitation**: Synthetic activity notifications ("34 people looking at this right now").
+4. **Forced Continuity**: Easy one-click signups combined with labyrinthine cancellation flows.
+5. **Confirm-shaming**: Emotionally manipulative copy on opt-out buttons ("No thanks, I hate saving money").
+6. **Hidden Costs**: Unannounced fees revealed only on the final checkout screen.
+
+---
+
+## 🛠️ Development & Transparency Note
+Designed and developed by **Jayan Gupta**. The taxonomy and heuristics are based on FTC consumer protection guidelines and academic dark-pattern datasets. AI assistants were used for prototyping and documentation structuring.