Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

lyfmail-official/pdpr

Repository files navigation

PDPR β€” Public Dark Pattern Registry & Ethical UX Detection Tool

Expose, document, and neutralize manipulative user-interface practices. A free, open-source dark pattern detection platform for consumer protection and digital rights awareness.

Live App Privacy First PWA Ready Open Source Maintained by LYF Mail

"Consumer protection through literacy, not litigation."
A free, open-source public infrastructure for ethical UX transparency and dark pattern detection from LYF Mail β€” India's privacy-first digital wellness platform.


🌍 What Is PDPR?

PDPR (Public Dark Pattern Registry) is a global, open-source, privacy-first public infrastructure dedicated to exposing, documenting, and neutralizing manipulative user-interface practices commonly known as dark patterns.

Instead of public shaming, legal battles, or corporate punishment, PDPR focuses on:

  • πŸ“š Education β€” teaching users to recognize manipulation.
  • πŸ” Awareness β€” making deceptive UX visible and understandable.
  • 🧬 Scientific detection β€” pattern analysis grounded in behavioral science.
  • βš–οΈ Ethical transparency β€” open methodologies, auditable logic, honest limitations.
  • πŸ›‘οΈ Public digital literacy β€” empowering consumers to defend themselves.

PDPR is not a commercial product, compliance tool, or legal enforcement system. It is a civic technology initiative, a public educational registry, a digital rights awareness system, and an ethical UX research platform β€” built to immunize society against manipulation, not merely punish it.

Built by LYF Mail, a privacy-first digital wellness platform serving 50,000+ subscribers across India since 2020, PDPR extends our mission of "Every Choice Shapes Tomorrow" into ethical technology and consumer protection.


🧠 Why PDPR Exists β€” The Dark Pattern Problem

Dark patterns are intentionally deceptive design choices that exploit cognitive biases to manipulate users into actions they would not otherwise take. They are everywhere online:

  • πŸ•³οΈ Roach Motel β€” easy to get in, nearly impossible to get out (subscriptions, accounts).
  • 🎭 Disguised Ads β€” advertisements designed to look like content or navigation.
  • 🎁 Bait & Switch β€” promising one thing, delivering another.
  • ⏰ Urgency & Scarcity β€” fake countdown timers, false stock alerts.
  • πŸ”’ Privacy Zuckering β€” tricking users into sharing more data than intended.
  • πŸ’° Hidden Costs β€” sneaking fees into the final checkout step.
  • πŸ“§ Forced Continuity β€” making cancellation difficult, hidden, or impossible.

The Real-World Impact

Dark Pattern How It Hurts Users PDPR's Response
Tricky Subscriptions Users pay for months without knowing. Pattern Registry + Learn Mode training.
Fake Urgency Panic purchases, regret, financial loss. Quick Scan detection + psychology context.
Privacy Traps Unknowingly surrendering personal data. Ethics Constitution + transparency reports.
Hidden Fees Paying 30-50% more than expected. Public documentation + defensive strategies.
Difficult Cancellations Trapped in unwanted services. Awareness campaigns + UX literacy tools.

Most users feel manipulated but cannot explain how. PDPR provides the language, tools, and knowledge to recognize, understand, and resist manipulation β€” turning passive victims into informed digital citizens.


βœ… What PDPR Is

  • βœ” A public educational registry of dark patterns with scientific documentation.
  • βœ” A privacy-first dark pattern detection tool β€” scan webpages without exposing your data.
  • βœ” A consumer protection platform β€” empowering users to defend themselves.
  • βœ” A digital rights awareness system β€” bridging the gap between UX design and user dignity.
  • βœ” An ethical UX research platform β€” studying manipulation through behavioral science.
  • βœ” A Progressive Web App (PWA) β€” installable, offline-first, accessible anywhere.
  • βœ” A community-governed open-source project β€” transparent, auditable, collaborative.

❌ What PDPR Is NOT

  • ✘ Not a commercial product β€” no monetization, no premium tiers, no paywalls.
  • ✘ Not a compliance tool β€” we don't certify, audit, or legally evaluate companies.
  • ✘ Not a legal enforcement system β€” no accusations, no shaming, no litigation support.
  • ✘ Not a corporate punishment platform β€” education over retaliation.
  • ✘ Not a surveillance system β€” zero tracking, zero fingerprinting, zero data collection.

🧩 Core Modules & Features

1. πŸ“š Pattern Registry β€” Global Public Archive

A searchable, open database of documented dark patterns across the web:

  • Categorized by type β€” roach motels, disguised ads, bait & switch, urgency traps, privacy zuckering, hidden costs, forced continuity.
  • Real-world examples β€” screenshots, descriptions, and ethical analysis.
  • Scientific context β€” psychological principles exploited by each pattern.
  • Community submissions β€” crowd-sourced documentation with ethical review.

2. πŸ” Quick Scan β€” Dark Pattern Detection Engine

An educational, privacy-first webpage scanner that analyzes UX in real-time:

  • Client-side detection β€” all analysis happens in your browser, no data sent to servers.
  • Pattern recognition β€” identifies common manipulation frameworks in live websites.
  • Risk scoring β€” assigns manipulation risk levels with explainable reasoning.
  • Privacy-first scanning β€” zero personal data collection, zero tracking, zero fingerprinting.

3. πŸŽ“ Learn Mode β€” Interactive Dark Pattern Literacy Training

A gamified educational module that teaches users to spot manipulation:

  • Interactive examples β€” test your ability to identify dark patterns.
  • Psychology explanations β€” understand the cognitive biases being exploited.
  • Defensive strategies β€” learn practical techniques to avoid manipulation.
  • Progress tracking β€” build your UX literacy score over time (stored locally only).

4. 🧬 Psychology Mapping β€” Behavioral Science Explanations

Deep dives into the human psychology behind dark patterns:

  • Cognitive bias catalog β€” anchoring, scarcity bias, social proof, loss aversion.
  • Neurological impact β€” how manipulation triggers stress and impulsive decisions.
  • Vulnerability factors β€” why certain populations (elderly, low-income, non-tech-savvy) are disproportionately targeted.
  • Behavioral economics β€” the science of choice architecture and nudging.

5. βš–οΈ Ethics Constitution β€” Governance & Ethical Framework

A transparent, community-ratified document governing all PDPR activities:

  • Detection methodology standards β€” how we identify and document patterns.
  • Non-accusatory language β€” scientific framing, not corporate shaming.
  • Contributor ethics β€” standards for submissions, reviews, and community conduct.
  • Transparency requirements β€” open methodologies, auditable processes, honest limitations.

6. πŸ“Š Transparency Reports β€” Open Accountability System

Regular public reports on PDPR's own operations:

  • Detection accuracy metrics β€” how reliable our pattern recognition is.
  • Community contribution statistics β€” who is contributing, what is being documented.
  • Ethical review outcomes β€” how governance decisions are made.
  • Limitation disclosures β€” what PDPR cannot detect and why.

πŸ› οΈ Technical Architecture

PDPR is built with modern, privacy-first web technologies:

Feature Implementation Benefit
Progressive Web App (PWA) Service Worker + Manifest Installable on any device, works offline.
Offline-First Architecture Local Storage + Cache API Full functionality without internet.
Client-Side Detection Vanilla JavaScript Zero server-side processing of scanned content.
Privacy-First Scanning No Network Requests During Scan Your browsing data never leaves your device.
Zero Personal Data Collection No Cookies, No LocalStorage Tracking Complete anonymity by design.
Static-First Deployment JAMstack / Static Site Fast, secure, low-cost, globally distributed.
Modular UX Detection Engine Plugin-based Pattern Modules Easy to extend, test, and audit.

πŸ” Privacy & Ethics by Design

PDPR is built on uncompromising privacy principles:

  • βœ… Zero tracking β€” no analytics, no behavioral monitoring.
  • βœ… Zero fingerprinting β€” cannot identify individual users or devices.
  • βœ… No personal data storage β€” we don't know who you are or what you scanned.
  • βœ… No behavioral profiling β€” no user segments, no interest categories, no shadow profiles.
  • βœ… Client-side only β€” all detection happens in your browser. We never see the websites you analyze.
  • βœ… Open detection logic β€” every pattern rule is publicly documented and auditable.

Ethical Governance

All PDPR activities are governed by:

  • Public Ethics Constitution β€” ratified by the community, not corporate interests.
  • Open Governance Framework β€” transparent decision-making processes.
  • Transparent Detection Logic β€” every flag is explainable, every score is justified.
  • Auditable Methodologies β€” independent researchers can verify our detection standards.

🌐 Live Platform

πŸ‘‰ Try PDPR now: pdpr.lyfmail.com

  • Scan any webpage for dark patterns instantly.
  • Browse the public pattern registry.
  • Complete interactive literacy training.
  • Install as a PWA for offline access.
  • No account required. No tracking. Ever.

πŸ“ Project Structure

pdpr/
β”œβ”€β”€ public/ # Static PWA assets & HTML
β”‚ β”œβ”€β”€ index.html
β”‚ β”œβ”€β”€ scan/ # Quick Scan interface
β”‚ β”œβ”€β”€ registry/ # Pattern Registry browse & search
β”‚ β”œβ”€β”€ learn/ # Interactive Learn Mode
β”‚ └── manifest.json
β”œβ”€β”€ api/ # Optional API endpoints (community data)
β”œβ”€β”€ detection/ # Modular UX detection engine
β”‚ β”œβ”€β”€ patterns/ # Individual pattern detection modules
β”‚ β”œβ”€β”€ scoring/ # Risk scoring algorithms
β”‚ └── explainers/ # Human-readable explanation generators
β”œβ”€β”€ docs/ # Comprehensive documentation
β”‚ β”œβ”€β”€ governance.md # Ethics Constitution & governance
β”‚ β”œβ”€β”€ ethics-policy.md # Contributor ethics & conduct
β”‚ β”œβ”€β”€ methodology.md # Detection methodology standards
β”‚ β”œβ”€β”€ legal-safety.md # Legal disclaimers & safety notice
β”‚ └── psychology/ # Behavioral science deep dives
β”œβ”€β”€ registry-data/ # Public pattern database (JSON/YAML)
β”œβ”€β”€ tests/ # Detection engine test suite
β”œβ”€β”€ CONTRIBUTING.md
β”œβ”€β”€ CODE_OF_CONDUCT.md
β”œβ”€β”€ LICENSE
β”œβ”€β”€ README.md
└── SECURITY.md

πŸš€ Quick Start Guide

For Users (No Technical Knowledge Required)

  1. Visit pdpr.lyfmail.com
  2. Browse the Pattern Registry β€” learn what dark patterns look like.
  3. Try Quick Scan β€” paste any website URL to analyze its UX for manipulation signals.
  4. Complete Learn Mode β€” build your dark pattern literacy through interactive training.
  5. Install as PWA β€” tap "Add to Home Screen" on mobile for offline access.

For Developers & Researchers

  1. Clone the Repository
git clone https://github.com/lyfmail-official/pdpr.git
  1. Install Dependencies
cd pdpr
npm install # or your preferred package manager.
  1. Run Locally
npm run dev
  1. Explore the Detection Engine
cd detection/
# Modular pattern rules are in detection/patterns/.
# Each pattern is independently testable and auditable.
  1. Contribute a new pattern
# See docs/methodology.md for pattern submission standards.
# Submit via GitHub PR following CONTRIBUTING.md.

🀝 Contributing to PDPR

PDPR welcomes contributions from diverse disciplines:

  • 🎨 UX Designers β€” document patterns, suggest defensive design alternatives.
  • πŸ’» Developers β€” improve detection engine, build new modules, fix bugs.
  • 🧠 Psychologists & Behavioral Scientists β€” map cognitive biases, validate detection logic.
  • πŸ”¬ Researchers β€” study manipulation trends, publish findings via PDPR.
  • πŸ›‘οΈ Digital Rights Activists β€” advocate, educate, and spread awareness.
  • πŸŽ“ Students & Educators β€” build curricula, create training materials, teach digital literacy.

Before contributing, please read:


βš–οΈ Legal & Safety Notice

PDPR provides educational information only.

It does not accuse, shame, or legally evaluate companies, products, or individuals.

All detection is:

  • Probabilistic β€” pattern-based analysis, not definitive proof.
  • Non-accusatory β€” scientific framing, not corporate condemnation.
  • Scientifically framed β€” grounded in behavioral science and UX research.

Please read docs/legal-safety.md before contributing or using PDPR for research purposes.


πŸ›‘οΈ Mission Statement

To build the world's first public digital immune system against manipulation.

We believe that:

  • Users have a right to understand how interfaces manipulate them.
  • Designers have a responsibility to build honest, respectful interfaces.
  • Society deserves public infrastructure for digital literacy, not proprietary tools locked behind paywalls.
  • Education is more powerful than punishment in creating lasting change.

πŸ—οΈ The LYF Mail Ecosystem

PDPR is one of nine free, open-source privacy tools built by LYF Mail, a digital wellness platform from Varanasi, India, serving 50,000+ subscribers since 2020. Explore our other projects:

Project Description Live App Repository
LYF Mail Privacy-first newsletters for health, wealth, career & mindfulness. lyfmail.com lyfmail
TrustLens Detect misinformation before you share. Privacy-first credibility analysis. trustlens.lyfmail.com trustlens
Signals Privacy-first analytics. Human vs. bot detection without cookies or fingerprinting. signals.lyfmail.com signals
Ebb Period tracker with homomorphic encryption. Your data stays encrypted β€” even from us. ebb.lyfmail.com ebb
LYF SOS Offline emergency safety app for Android. Built for Indian families. lyfsos.lyfmail.com lyfsos
Together Mental health support through therapeutic silence and shared presence. together.lyfmail.com together
Rewriter AI-powered narrative therapy and health content writing assistant. lyfmail-official.github.io/rewriter rewriter
Offload Stress relief with binaural beats and dream journal. Zero cloud storage. lyfmail-official.github.io/offload offload

πŸ“š Free Newsletters & Guides

Newsletter Signups: Health Β· Finance Β· Career Β· Creativity Β· Personal Development


πŸ“œ License

PDPR is open-source and community-governed.

License selection is pending ethical governance ratification by the PDPR community. See LICENSE for current status and docs/governance.md for the ratification process.

All documentation and detection methodologies are openly published for public benefit.


πŸ“« Connect With Us


"Every Choice Shapes Tomorrow"

Maintained by LYF Mail Β· Founded by Ajay Kumar Chaudhary Β· Varanasi, Uttar Pradesh, India Β· Since 2020


πŸ’¬ Frequently Asked Questions

Q: What is a dark pattern?
A: A dark pattern is an intentionally deceptive user interface design that manipulates users into making choices they would not otherwise make β€” such as signing up for unwanted subscriptions, sharing excessive personal data, or paying hidden fees. PDPR documents and educates users about these manipulative practices.

Q: Is PDPR free to use?
A: Yes. PDPR is completely free and open-source. There are no premium tiers, no paywalls, and no advertising. It is a public civic technology initiative maintained by the community and supported by LYF Mail.

Q: Does PDPR track me or store my browsing data?
A: No. PDPR is privacy-first by design. All Quick Scan analysis happens entirely in your browser using client-side JavaScript. We never see, store, or process the websites you analyze. No cookies, no fingerprinting, no tracking.

Q: Can PDPR detect all dark patterns on any website?
A: No system is perfect. PDPR detects known, documented dark pattern frameworks using probabilistic analysis. New manipulation techniques emerge constantly, and some patterns require human judgment. PDPR is a powerful educational tool, not a definitive legal or technical audit system.

Q: Does PDPR name and shame companies?
A: No. PDPR is explicitly non-accusatory. We document patterns scientifically, not condemn specific companies. Our goal is education and awareness, not corporate punishment or public shaming.

Q: How can I contribute a new dark pattern?
A: Anyone can submit a new pattern via GitHub pull request. Please follow our methodology standards documented in docs/methodology.md and ethics guidelines in docs/ethics-policy.md. All submissions undergo community review for scientific accuracy and ethical framing.

Q: Is PDPR available as a mobile app?
A: PDPR is a Progressive Web App (PWA). Visit pdpr.lyfmail.com on your mobile browser and tap "Add to Home Screen" to install it like a native app β€” no app store required, no permissions demanded.

Q: Does PDPR work offline?
A: Yes. Once installed as a PWA, PDPR's Pattern Registry and Learn Mode work offline. Quick Scan requires an internet connection to fetch the target webpage, but the analysis itself happens locally in your browser.

Q: Who can use PDPR?
A: Everyone. PDPR is designed for everyday consumers, UX designers, digital rights advocates, researchers, students, educators, journalists, and policymakers. No technical knowledge is required.

Q: Is PDPR politically biased?
A: No. PDPR analyzes user interface manipulation patterns from a behavioral science perspective, independent of political content, corporate affiliation, or ideological position.

Q: Can I use PDPR for academic research?
A: Yes. PDPR is explicitly designed to support academic research into deceptive UX, behavioral economics, and digital consumer protection. Please cite PDPR and read our docs/legal-safety.md before publishing findings.

Q: How is PDPR different from commercial dark pattern detection tools?
A: Commercial tools often focus on legal compliance, corporate auditing, or selling remediation services. PDPR is a public educational infrastructure focused on consumer literacy, scientific transparency, and community governance β€” not profit.


This README is maintained by the LYF Mail team. For issues, feature requests, pattern submissions, or contributions, please visit our GitHub repository.

About

Public Dark Pattern Registry. Document and report deceptive UX patterns ethically. Open-source consumer protection tool.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /