Thanks to visit codestin.com
Credit goes to github.com

Skip to content

An ADHD-friendly Chrome extension that attaches todos to each website you visit. Stay focused and organized with contextual task management, built for clarity and simplicity.

License

Notifications You must be signed in to change notification settings

aminehabchi/NeuroFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

NeuroFlow - ADHD-Friendly Todo Chrome Extension

A thoughtfully designed Chrome extension specifically created to help individuals with ADHD manage their tasks more effectively. By organizing todos contextually based on the website you're visiting, NeuroFlow reduces cognitive load and helps maintain focus without overwhelming your working memory.

Screenshots

Light Theme Dark Theme
Light Theme Dark Theme

Why NeuroFlow is Perfect for ADHD

🧠 Reduces Cognitive Overload

  • Context-aware organization - Only see tasks relevant to your current website, preventing overwhelm
  • Clean, minimal interface - No distracting elements that can derail your focus
  • Visual task separation - Different websites = different task lists, matching how ADHD brains naturally compartmentalize

⚑ Works with ADHD Traits

  • Instant task capture - Quickly jot down thoughts before they disappear (we know how that feels!)
  • Visual progress tracking - Clear completed/active states provide dopamine-boosting sense of accomplishment
  • Contextual reminders - Tasks appear exactly where you need them, when you need them
  • No complex setup - Start using immediately without overwhelming configuration options

🎯 Supports Executive Function

  • Automatic organization - No need to remember which list to put tasks in
  • Clear visual filters - Easy switching between "all," "active," and "completed" views
  • Badge notifications - Gentle reminder of pending tasks without being intrusive
  • Persistent memory - Your tasks stay saved even when ADHD makes you forget to check them

Features Designed for Neurodivergent Minds

  • 🌐 Website-specific todos - Automatically organizes tasks by domain, reducing decision paralysis
  • πŸ” Smart filtering - View all, active, or completed tasks without cognitive overhead
  • πŸŒ™ ADHD-friendly themes - Dark mode reduces eye strain during hyperfocus sessions
  • πŸ“± Instant badge counter - Visual cue for pending tasks without overwhelming notifications
  • ⌨️ Quick keyboard shortcuts - Press Enter to add tasks when inspiration strikes
  • πŸ’Ύ Reliable persistence - Never lose your thoughts again - everything saves automatically
  • πŸš€ Zero friction - No complex setup or overwhelming options to configure

Real-World ADHD Use Cases

πŸ“š Research & Learning

  • On Wikipedia: "Read about quantum physics basics"
  • On YouTube: "Watch that coding tutorial I bookmarked"
  • On Khan Academy: "Complete linear algebra practice problems"

πŸ’Ό Work & Productivity

  • On GitHub: "Fix the authentication bug", "Write unit tests for user service"
  • On Google Docs: "Finish quarterly report", "Review team feedback"
  • On Slack: "Follow up with Sarah about project timeline"

πŸ›’ Daily Life Management

  • On Amazon: "Buy birthday gift for mom", "Order those ADHD books"
  • On Recipe sites: "Try this pasta recipe this weekend"
  • On Banking sites: "Set up automatic savings transfer"

🎯 Hyperfocus Sessions

When you're deep in a coding session on Stack Overflow, you'll only see coding-related tasks. When browsing social media, you'll see social tasks. No mental context switching required!

Installation

  1. Clone or download this repository
  2. Open Chrome and navigate to chrome://extensions/
  3. Enable "Developer mode" in the top right corner
  4. Click "Load unpacked" and select the extension folder
  5. The extension icon should appear in your Chrome toolbar

Usage

Quick Task Capture (The ADHD Superpower)

  1. Having a random thought while browsing? Click the extension icon
  2. Type your task immediately (before it vanishes!)
  3. Press Enter - done! No menus, no categories to choose from
  4. Your task is automatically organized by the website you're on

Managing Your Tasks (Executive Function Made Easy)

  • Complete tasks: Click the checkbox - get that dopamine hit! βœ…
  • Remove tasks: Click "X" when something's no longer relevant
  • Filter your view:
    • "All" - see everything for this website
    • "Active" - focus on what needs doing
    • "Completed" - celebrate your wins!

Theme for Your Brain

  • Click πŸŒ™/β˜€οΈ to switch themes
  • Dark mode: Perfect for late-night hyperfocus sessions
  • Light mode: Great for daytime productivity
  • Your preference saves automatically (one less thing to remember!)

File Structure

neuroflow-extension/
β”œβ”€β”€ main.js                    # Main application logic and UI handling
β”œβ”€β”€ list.js                    # Todo list management class
β”œβ”€β”€ manifest.json              # Chrome extension manifest
β”œβ”€β”€ popup.html                 # Extension popup interface
β”œβ”€β”€ light-style.css            # Light theme styles
β”œβ”€β”€ dark-style.css             # Dark theme styles
β”œβ”€β”€ screenshots/               # Extension screenshots
β”‚   β”œβ”€β”€ neuroflow-light.png    # Light theme interface
β”‚   β”œβ”€β”€ neuroflow-dark.png     # Dark theme interface
β”‚   β”œβ”€β”€ context-demo.gif       # Context switching demonstration
β”‚   └── badge-counter.png      # Badge counter example
└── README.md                  # This file

Key Components

LIST Class (list.js)

Handles all todo operations including:

  • Adding/removing todos
  • Toggling completion status
  • Filtering by status (all/active/completed)
  • Website-specific todo management

Main Application (main.js)

  • UI event handling
  • Theme management
  • Chrome extension API integration
  • Todo rendering and display

Browser Permissions

This extension requires the following permissions:

  • tabs - To detect the current website domain
  • storage - To persist todos and theme preferences
  • activeTab - To access the current tab information

Development

Prerequisites

  • Google Chrome browser
  • Basic knowledge of JavaScript, HTML, and CSS

Local Development

  1. Make changes to the source files
  2. Go to chrome://extensions/
  3. Click the refresh icon on your extension to reload changes
  4. Test the updated functionality

Technical Details (For the Developer ADHD Brain)

  • 🎯 Context Recognition: Uses chrome.tabs.query() to detect current website domain
  • 🧠 Memory Support: Chrome local storage ensures nothing gets lost during brain fog
  • πŸ‘οΈ Visual Feedback: Badge updates with chrome.action.setBadgeText() for non-intrusive awareness
  • ⚑ Instant Response: No loading delays that break hyperfocus flow
  • πŸ”„ State Management: Smart filtering without overwhelming cognitive load

ADHD-Friendly Development Features

  • Minimal cognitive overhead in code structure
  • Clear separation of concerns - easier to understand and modify
  • No complex state management - keeps it simple for contributors with ADHD
  • Immediate visual feedback for all actions

Contributing (Neurodivergent-Friendly)

We welcome contributions from the ADHD/neurodivergent community!

Getting Started (ADHD-Friendly Steps)

  1. Fork the repo (one click - easy!)
  2. Make your changes (hyperfocus time!)
  3. Test it works (satisfying immediate feedback)
  4. Submit PR (share your genius with the world)

Contribution Ideas

  • 🎨 More ADHD-friendly themes (high contrast, dyslexia-friendly fonts)
  • ⏰ Optional time-based reminders (gentle, not overwhelming)
  • 🏷️ Simple tagging system (without complexity)
  • πŸ“± Better mobile experience
  • πŸ”Š Optional audio feedback for task completion

We understand executive dysfunction - contribute when you can, how you can. Every small improvement helps the ADHD community!

License

This project is open source and available under the MIT License.

Support & Community

Need Help?

If you're struggling with the extension or have ideas for ADHD-friendly improvements, please reach out! We understand that sometimes explaining technical issues can be challenging with ADHD - just describe what's happening in your own words. Join our Discord community

Join Our Community

Connect with other ADHD individuals using NeuroFlow:

  • Share productivity tips that work with your brain
  • Suggest features that would help your specific ADHD challenges
  • Celebrate wins (we love dopamine-boosting success stories!) Join our Discord community

A Note from Neurodivergent Developers to Neurodivergent Users

We built NeuroFlow because we get it. We know the frustration of losing brilliant ideas, the overwhelm of complex productivity systems, and the joy of finding tools that actually work with our brains instead of against them.

This extension is our gift to the ADHD community - a simple tool that respects how our minds work. No judgment, no "fixing" needed - just support for your beautiful, creative, scattered, brilliant brain.

You've got this. And now you've got NeuroFlow to help. 🧠✨


"Finally, a todo app that doesn't make me feel like I'm failing at being neurotypical." - Beta tester with ADHD

About

An ADHD-friendly Chrome extension that attaches todos to each website you visit. Stay focused and organized with contextual task management, built for clarity and simplicity.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published