ADHD Hacker

Hack Your Brain, Master Your Day - Science-backed tools and techniques designed for the way you actually think.

Features

• Focus Timer - Pomodoro-style timer with ADHD-friendly tweaks
• Brain Dump - Clear mental clutter instantly
• Task Breaker - Smash big tasks into tiny wins
• Energy Tracker - Find your peak performance hours
• Reward System - Gamify your productivity
• Quick Wins - Instant tips for immediate focus

ADHD-Friendly Design

The color palette is specifically chosen based on research for ADHD-friendly environments:

• Calming Teal Blue (#4A9B9B) - Primary color, reduces anxiety
• Soft Sage Green (#7BA387) - Balancing, easy on eyes
• Warm Earth Tones - Grounding and non-overstimulating
• Minimal harsh colors - Avoids sensory overload

Quick Start

Using Docker Compose (Recommended)

# Production mode
docker-compose up -d

# Access at http://localhost:8080

Development Mode (with live reload via volume mounts)

docker-compose --profile dev up adhdhacker-dev

# Access at http://localhost:3000

Using Docker directly

# Build the image
docker build -t adhdhacker .

# Run the container
docker run -d -p 8080:80 --name adhdhacker adhdhacker

# Access at http://localhost:8080

Without Docker

Simply open index.html in your browser, or serve with any static file server:

# Using Python
python -m http.server 8080

# Using Node.js
npx serve .

Keyboard Shortcuts

• Space - Start/Pause Timer
• R - Reset Timer
• B - Open Brain Dump
• Escape - Close any modal

Project Structure

adhdhacker/
├── index.html          # Main HTML file
├── styles.css          # ADHD-friendly styled CSS
├── app.js              # Interactive functionality
├── Dockerfile          # Docker configuration
├── docker-compose.yml  # Docker Compose setup
├── nginx.conf          # Nginx configuration
└── README.md           # This file

License

MIT License - Use it, share it, hack your ADHD!