🧠 DopeDecay

Personal Dopamine Response & Motivation Decay Tracker

Understand your creative half-life. Ship before the dopamine dies.

⚡ The Problem It Solves

Every builder knows this cycle:

1. 🔥 Hyperfocus Phase: "This is AMAZING! I'm a genius!"
2. 📉 Steady Decline: "Well, it's still pretty cool..."
3. 😐 The Plateau: "Oh right, I made that thing"
4. 💀 The Abyss: "What was I even thinking?"

Projects die not from lack of skill, but from dopamine decay. DopeDecay makes this invisible force VISIBLE and ACTIONABLE.

🧬 The Science Behind It

DopeDecay models your motivation using the exponential decay equation:

motivation(t) = initial_excitement × e^(-ln(2) × t / half_life)

Where:

• t = hours since project completion
• half_life = your personal "dopamine half-life" (discover yours!)
• initial_excitement = your peak motivation level

This isn't just a metaphor—it's the same mathematics used in pharmacology, radioactive decay, and yes, your creative energy.

✨ Features

🎯 Core Tracking

• Real-time Decay Visualization: Watch your motivation curve drop in real-time
• Personal Half-Life Calculator: Discover your unique decay rate (1-72 hours)
• Action Threshold Setting: Define when you need intervention
• Four Action Zones: Know exactly what window you're in

📊 Four Action Zones

Zone	Timeframe	Mindset	Optimal Actions
🟢 PEAK	0-6 hours	"This is amazing! I'm a genius!"	Building, creating, polish
🟡 VIABLE	6-24 hours	"This is still cool, I should do something"	Marketing, outreach, docs
🟠 DANGER	24-72 hours	"Oh right, I made that thing"	External deadlines, accountability
🔴 DEAD	72+ hours	"What was I even thinking?"	Archival, retrospectives

🔧 Behavioral Modifiers

• Sleep Reset Toggle: Does sleep reset your motivation?
• Coffee Boost: +15% motivation after caffeine
• Public Commitment: Add social pressure to fight decay
• Project Type Adjustments: Different decay rates for coding/writing/business

📈 Insights & Patterns

• Abandonment Risk Calculator: Probability scores for project survival
• Historical Analysis: See which project types you complete vs. abandon
• Personal Decay Rate: Calculate your actual dopamine half-life from data
• Optimal Timing Recommendations: "Send emails within 3 hours" type suggestions

📱 Mobile-First Design

• Touch-optimized sliders and controls
• PWA-ready - install as a native app
• Works offline - all data stored locally
• High contrast for accessibility
• Swipe-friendly tab navigation

🚀 Quick Start

1. Open the app: Just open index.html in any browser
2. Start your first project: Click "Start New Project"
3. Set your parameters: Adjust sliders to match your experience
4. Watch the decay: See your motivation drop in real-time
5. Act before it's too late: Use the action recommendations

No signup. No backend. No tracking. Just you and your dopamine.

🧠 Who It's For

🎨 Creative Professionals

"I have 47 half-finished Figma files. DopeDecay showed me I have a 9-hour creative half-life. Now I schedule client reviews at hour 8."

💻 ADHD Developers

"My coding projects used to die at 36 hours. With the 'public commitment' toggle on, my completion rate went from 22% to 78%."

🚀 Startup Founders

"Founder's worst enemy isn't competition—it's our own decaying excitement for yesterday's brilliant idea."

📝 Writers & Researchers

"The 'morning after' reset is real. If I don't write within 12 hours of inspiration, it's gone forever."

📊 Data Model

Project: {
  name: "My Awesome SaaS",
  type: "coding", // coding/writing/business
  startTime: "2024-01-15T14:30:00Z",
  completionTime: "2024-01-16T08:00:00Z",
  initialExcitement: 92, // 0-100%
  abandoned: false,
  abandonTime: null,
  actions: [] // What you did at which motivation level
}

DecayProfile: {
  halfLife: 14.2, // hours
  actionThreshold: 45, // percentage
  sleepResets: true,
  coffeeBoost: false,
  publicCommitment: true
}

🔬 The Math

1. Motivation at Time t

motivation(t) = initial × e^(-ln(2) × hours / halfLife)

2. Time to Threshold

timeToThreshold = -halfLife × ln(threshold/current) / ln(2)

3. Abandonment Probability

probability = 1 / (1 + e^(-k × (threshold - current)))

🎮 Psychological Features

Double-Meaning Naming

"DopeDecay" works both as:

1. Dopamine Decay (the neuroscience)
2. Dope Decay (the "this was cool but now it's not" feeling)

Gamification

• Beat your personal decay rate
• Maintain completion streaks
• Unlock insights about your patterns

Accountability Engineering

• Public commitment toggle
• Emergency "ACT NOW" button in danger zone
• Reminders before critical thresholds

Pattern-Based Interventions

"Based on 14 projects: You need coffee + public commitment for business tasks. Coding projects decay 40% faster than writing."

📱 Mobile Optimizations

• Touch-friendly sliders with large thumbs (44px minimum)
• Swipe gestures between tabs
• Offline-first architecture (localStorage)
• PWA manifest for iOS/Android home screen install
• High contrast mode for low vision users
• Reduced motion preferences respected
• Keyboard navigation for accessibility

🔧 Tech Stack

• Pure HTML/CSS/JS - No frameworks, no build step
• Plotly.js - Beautiful, interactive charts
• Font Awesome - Icon system
• CSS Variables - Theming and customization
• LocalStorage - Zero backend, total privacy
• PWA Standards - Installable, offline-capable

🚨 Emergency Features

The Red Button

When entering the danger zone (24-72 hours):

• Pulsing emergency button appears
• +25% motivation boost when clicked
• Last-chance notifications: "This is your final window!"

Smart Interventions

• "Your abandonment risk is 82% - call a co-founder NOW"
• "Schedule a demo before your excitement drops below 40%"
• "Write the README while you still care"

📈 What Users Discover

Common "Aha!" Moments:

1. "My half-life is 18 hours, not 'a few days'"
2. "Sleep DOES reset my motivation by ~20%"
3. "Business tasks decay 2.3x faster than creative work"
4. "The 'morning after' is my most critical decision point"
5. "Public commitment adds 12 hours to my viable window"

Sample Insights Generated:

"You abandon 60% of projects between 36-48 hours. Set a calendar reminder at hour 30."

"Your writing projects have a 28-hour half-life vs 14 hours for coding. Write first, code later."

"Coffee + public commitment = 42% higher completion rate. Use both for critical projects."

🎯 Philosophy

You're not just building products. You're building MODELS OF YOURSELF.

• ToothForge = Model of dental decay
• CaffeineForge = Model of drug metabolism
• DopeDecay = Model of your motivation

All using the same math: value(t) = value₀ × e^(-k × t)

🌈 Color Psychology

Color	Hex	Purpose
Primary Purple	#8B5CF6	Neuroscience theme, calming focus
Energy Amber	#F59E0B	Warning states, action required
Success Green	#10B981	Peak window, optimal state
Danger Red	#EF4444	Critical alerts, emergency states

📄 License

MIT License - use it, modify it, ship with it. Just don't sue us if you discover your dopamine half-life is shorter than you hoped.

🙏 Acknowledgments

Built for the ADHD builders, the neurodivergent creators, and anyone who's ever said "I'll finish it tomorrow" knowing full well they won't.

The math doesn't lie. Your motivation decays. Now you can see it coming.

---

🚀 Immediate Next Steps

1. Open index.html in your browser
2. Start tracking your next project
3. Discover your personal decay rate
4. Ship before the dopamine dies

Your future self will thank your present self for understanding this.

---

DopeDecay: Because motivation isn't infinite. It's exponential.