{"id":42651669,"url":"https://github.com/monch1962/gtd-web","last_synced_at":"2026-02-02T00:01:27.708Z","repository":{"id":331570591,"uuid":"1128156364","full_name":"monch1962/GTD-web","owner":"monch1962","description":"Browser implementation of GTD, including storage sync across devices and browsers","archived":false,"fork":false,"pushed_at":"2026-01-20T23:55:34.000Z","size":5822,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-29T21:53:56.680Z","etag":null,"topics":["ai-generated","browser","gtd","gtd-applications"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/monch1962.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-05T08:16:14.000Z","updated_at":"2026-01-20T23:55:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/monch1962/GTD-web","commit_stats":null,"previous_names":["monch1962/gtd-web"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/monch1962/GTD-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monch1962%2FGTD-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monch1962%2FGTD-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monch1962%2FGTD-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monch1962%2FGTD-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/monch1962","download_url":"https://codeload.github.com/monch1962/GTD-web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monch1962%2FGTD-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28996568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T23:10:54.274Z","status":"ssl_error","status_checked_at":"2026-02-01T23:10:47.298Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-generated","browser","gtd","gtd-applications"],"created_at":"2026-01-29T07:34:19.513Z","updated_at":"2026-02-02T00:01:27.694Z","avatar_url":"https://github.com/monch1962.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GTD Web\n\nA full-featured Getting Things Done (GTD) productivity application that runs\nentirely in your browser. Implement David Allen's GTD methodology to stay\norganized and productive.\n\n![GTD Web](https://img.shields.io/badge/version-2.3.0-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n\n## Features\n\n### Core GTD Workflow\n\n- **Inbox** - Quick capture for all new tasks and ideas\n- **Next Actions** - Actionable tasks you can do right now\n- **Waiting** - Tasks blocked on dependencies or external factors\n- **Someday** - Tasks for future consideration\n- **Projects** - Multi-step outcomes with task tracking and health indicators\n- **Reference** - Non-actionable information storage\n\n### Advanced Features\n\n- **🔄 Advanced Recurrence** - Set specific days for weekly (Mon/Wed/Fri), nth\n  weekday for monthly (3rd Thursday), specific dates for yearly (Jan 15th)\n- **🔗 Drag-and-Drop Dependencies** - In project view, drag tasks onto each\n  other to create dependencies with visual feedback\n- **📦 Project Archive/Delete** - One-click archive or delete for\n  empty/completed projects with restore functionality\n- **Auto-Assign to Project** - Tasks created in project view automatically\n  assign to that project\n- **Circular Dependency Prevention** - Automatic detection and blocking of\n  circular dependencies using BFS algorithm\n- **Task Dependencies Visualization** - Visual graphs, dependency chains, and\n  critical path analysis\n- **Productivity Heatmap** - GitHub-style contribution calendar showing 365 days\n  of activity\n- **Global Quick Capture** - Press Alt+N anywhere to instantly capture tasks\n  with natural language parsing\n- **Focus Timer Auto-Integration** - Auto-start timer in Focus Mode, auto-stop\n  on completion, auto-track time\n- **Task Priority Scoring** - Automatic 0-100 scores based on multiple factors\n  (due date, energy, dependencies, age)\n- **Archive System** - Archive completed tasks to keep your workspace clean\n- **Quick Actions Menu** - Right-click context menu for fast task operations\n- **Smart Date Suggestions** - Natural language parsing (in 3 days, tomorrow,\n  next week)\n- **Task Countdown Badges** - Visual days-remaining indicators on due tasks\n- **Enhanced Analytics** - Productivity trends, task lifecycle duration,\n  completion velocity\n- **Bulk Operations** - Set status, energy, context, due dates on multiple tasks\n  at once\n- **Dark Mode** - Easy-on-the-eyes dark theme with system preference detection\n- **Calendar View** - Visual calendar showing tasks by due date\n- **Focus Mode** - Full-screen single-task focus with integrated Pomodoro timer\n  (25/5 intervals)\n- **Task Notes** - Add detailed notes and progress updates to tasks\n- **Subtasks \u0026 Checklists** - Break down tasks into manageable steps with\n  progress tracking\n- **Quick Capture Widget** - Floating button for instant task capture from any\n  view\n- **Undo/Redo System** - Full history tracking with keyboard shortcuts\n  (Ctrl+Z/Ctrl+Y)\n- **Advanced Sorting** - Sort by due date, creation date, time estimate, or\n  title\n- **Time Analytics** - Dashboard showing time spent by context and project\n- **Project Health Indicators** - Visual progress bars and health status for all\n  projects\n- **Natural Language Parsing** - Quick task entry with smart context/energy/time\n  extraction\n- **Smart Suggestions** - AI-powered task recommendations based on your patterns\n- **Recurring Tasks** - Advanced recurrence with specific day selection\n  (backward compatible with simple daily/weekly/monthly/yearly)\n- **Task Dependencies** - Set tasks that must complete before others become\n  actionable (drag-and-drop or manual)\n- **Smart Context System** - Default contexts (@home, @work, @personal,\n  @computer, @phone) plus custom contexts\n    - All contexts automatically start with @ for easy identification\n- **Gantt Charts** - Visual dependency diagrams for projects\n- **Due Dates \u0026 Defer Dates** - Schedule deadlines and hide tasks until they're\n  relevant\n- **Project Management** - Create projects directly or convert tasks to projects\n- **Automatic Workflow** - Tasks move from Inbox to Next Actions when assigned\n  to projects\n- **Visual Indicators** - See overdue tasks, blocked tasks, and pending\n  dependencies at a glance\n- **Task Starring/Pinning** - Mark important tasks with stars to keep them at\n  the top of your lists\n- **Task Templates** - Create reusable task templates for repetitive workflows\n  (weekly reports, meeting notes, checklists)\n- **Daily Review Mode** - Quick daily workflow with time-based greeting, urgent\n  tasks, and quick actions\n- **Quick Edit Inline** - Double-click any task title to edit it instantly\n  without opening a modal\n- **Saved Filter Presets** - Save and load custom filter combinations for\n  frequently-used searches\n- **Enhanced Mobile Support** - Touch-optimized interface with 44px touch\n  targets, full-screen modals, and responsive design\n\n### User Experience\n\n- **Quick Task Capture** - Fast task entry with keyboard shortcuts\n- **Custom Contexts** - Create your own contexts (auto-formatted with @ prefix)\n- **Drag \u0026 Drop** - Reorder tasks and assign tasks to projects by dragging\n- **Responsive Design** - Works on desktop and mobile browsers\n- **Local-First Storage** - All data stays private in your browser\n- **PWA Support** - Install as a Progressive Web App for offline use\n- **Export/Import** - Backup and restore your data as JSON\n\n## Installation\n\n### Prerequisites\n\n- Node.js (v16 or higher)\n- npm (comes with Node.js)\n\n### Setup\n\n1. **Clone or download the repository**\n\n    ```bash\n    cd /path/to/GTD-web\n    ```\n\n2. **Install dependencies**\n\n    ```bash\n    npm install\n    ```\n\n3. **Start the application**\n\n    ```bash\n    npm start\n    ```\n\n4. **Open in your browser**\n    ```\n    http://localhost:8080\n    ```\n\nThat's it! The application runs entirely in the browser with no backend\nrequired.\n\n## Building for Production\n\nThe app uses Vite to bundle all code into a single optimized HTML file for\ndeployment.\n\n### Development Mode (with HMR)\n\n```bash\nnpm run dev\n```\n\n- Starts Vite dev server on port 8080\n- Hot Module Replacement for fast development\n- File watcher for instant updates\n\n### Production Build\n\n```bash\nnpm run build\n```\n\n- Creates optimized, minified single-file bundle in `dist/` directory\n- Single HTML file with all CSS and JavaScript inlined (~425 KB, ~84 KB gzipped)\n- PWA manifest file (cannot be inlined due to browser requirements)\n- Console statements removed for production\n- All dependencies bundled (including remote-storage)\n\n### Preview Production Build\n\n```bash\nnpm run preview\n```\n\n- Preview the production build locally\n- Serves files from `dist/` directory\n- Tests the bundled application\n\n### Deployment\n\nDeploy the `dist/` directory to any static hosting service:\n\n- **GitHub Pages**: Push to `gh-pages` branch\n- **Netlify**: Drag and drop the `dist/` folder\n- **Vercel**: Connect your GitHub repository\n- **AWS S3 + CloudFront**: Upload `dist/` contents\n- **Any static hosting**: Upload `dist/` folder contents\n\nThe bundled application:\n\n- ✅ Single HTML file contains all application code and styles (inline)\n- ✅ Works offline (PWA support preserved via manifest.json)\n- ✅ All tests and documentation excluded from bundle\n- ✅ Optimized and minified for fast loading\n- ✅ Simple two-file deployment (index.html + manifest.json)\n\n## Running Tests\n\nThe project includes comprehensive unit tests for the data models.\n\n```bash\n# Run all tests\nnpm test\n\n# Run tests with coverage\nnpm test -- --coverage\n\n# Run tests in watch mode\nnpm test -- --watch\n```\n\n## Usage Guide\n\n### Getting Started with GTD\n\n1. **Capture Everything** - Use the Inbox or Quick Capture to quickly capture\n   all tasks, ideas, and commitments\n2. **Process Your Inbox** - Decide what each item means and where it belongs\n3. **Organize by Context** - Use contexts like @home, @work, @computer to\n   categorize\n4. **Review Regularly** - Use the Weekly Review to check projects, waiting\n   items, and someday/maybe tasks\n5. **Do by Context** - Find the right task for your current context and\n   situation\n\n### Creating Tasks\n\n**Quick Add (Fastest)**\n\n1. Type your task in the quick-add input box\n2. Optionally click context buttons to add them\n3. Press Enter\n\n**Quick Capture Widget**\n\n1. Click the floating + button (bottom-right corner)\n2. Type your task\n3. Press Enter to capture instantly\n4. Works from any view without navigation\n\n**Natural Language Entry**\n\n- Type: \"Call mom @phone high 30min tomorrow\"\n- Automatically extracts: context (@phone), energy (high), time (30min), due\n  date (tomorrow)\n\n**Detailed Add**\n\n1. Click the \"Add Task\" button\n2. Fill in the form:\n    - Title and description\n    - Notes (detailed information)\n    - Status (Inbox, Next Actions, Waiting For, etc.)\n    - Energy level (high, medium, low)\n    - Time estimate\n    - Due date and defer date\n    - Project assignment\n    - Contexts\n    - Subtasks/checklist items\n3. Click Save\n\n### Managing Projects\n\n**Creating Projects**\n\n1. Click the \"New Project\" button in the header (folder icon), OR\n2. Create a task and change its Type to \"Project\" in the edit form\n3. Projects show progress bars and health indicators\n\n**Project Health Indicators**\n\n- 🟢 **Good**: No overdue tasks, manageable task count\n- 🟡 **Warning**: 1-2 overdue tasks or more than 10 tasks\n- 🔴 **Critical**: 3+ overdue tasks\n- ⚪ **Empty**: Project has no tasks yet\n\n**Project Progress**\n\n- Visual progress bar shows completion percentage\n- Stats display: \"5/10 tasks (50%)\"\n- Overdue task count shown when applicable\n\n### Using Focus Mode\n\n1. Click the \"Focus Mode\" button (bullseye icon) in the header\n2. Select a task from smart suggestions\n3. Work on the task in a distraction-free full-screen view\n4. Use the Pomodoro timer:\n    - **Start**: Begin 25-minute work session\n    - **Pause**: Temporarily stop the timer\n    - **Reset**: Reset timer to 25:00\n5. At the end of 25 minutes, choose to take a 5-minute break or continue\n\n### Using the Calendar View\n\n1. Click the \"Calendar View\" button (calendar icon) in the header\n2. See all tasks displayed on their due dates\n3. Navigate between months using prev/next buttons\n4. Click on tasks to see details\n\n### Working with Notes\n\n**Adding Notes**\n\n1. Edit any task\n2. Use the Notes textarea to add detailed information\n3. Notes are great for:\n    - Progress updates\n    - Meeting notes\n    - Reference information\n    - Brainstorming ideas\n\n**Viewing Notes**\n\n- Click the notes icon (sticky note) on any task card\n- Icon turns blue when task has notes\n- Quick preview without opening edit modal\n\n### Managing Subtasks\n\n**Creating Subtasks**\n\n1. Edit a task\n2. Scroll to the \"Subtasks / Checklist\" section\n3. Click \"Add\" or type in the input field\n4. Press Enter or click \"Add\" button\n\n**Using Subtasks**\n\n- Check off items as you complete them\n- Progress shows on task card (e.g., \"2/5 subtasks\")\n- First 3 incomplete subtasks display inline\n- Great for:\n    - Multi-step processes\n    - Shopping lists\n    - Checklists\n    - Procedure tracking\n\n### Advanced Filtering \u0026 Sorting\n\n**Sorting Options**\n\n- **Recently Updated** (default) - Most recently modified tasks first\n- **Due Date** - Tasks due soonest first\n- **Date Created** - Newest tasks first\n- **Time Estimate** - Longest tasks first\n- **Title (A-Z)** - Alphabetical order\n\n**Advanced Filters**\n\n- Click in the search box to open advanced filters\n- Filter by multiple criteria simultaneously:\n    - Context\n    - Energy level\n    - Status\n    - Due date (overdue, today, this week, this month, no date)\n    - Sort option\n- Save frequently-used searches for quick access\n\n### Undo/Redo\n\n**Keyboard Shortcuts**\n\n- `Ctrl+Z` - Undo last action\n- `Ctrl+Y` or `Ctrl+Shift+Z` - Redo\n\n**Button Interface**\n\n- Click undo/redo arrows in the header\n- Buttons are disabled when no history available\n- Toast notifications show what was undone/redone\n\n**Tracked Actions**\n\n- Create/edit/delete tasks\n- Create/edit/delete projects\n- Toggle task completion\n- Duplicate tasks\n- All actions are reversible (up to 50 states)\n\n### Time Tracking \u0026 Analytics\n\n**Tracking Time**\n\n1. Click the timer icon on any task\n2. Click \"Start\" to begin tracking\n3. Click \"Stop\" when done\n4. Time is saved automatically\n\n**Viewing Analytics**\n\n1. Click the \"Dashboard\" button (chart icon)\n2. See time tracking section with:\n    - **Total Time Tracked**: Sum of all time spent\n    - **Tasks with Time**: Count of tracked tasks\n    - **Average Time/Task**: Mean time per completed task\n    - **Time by Context**: Bar chart showing distribution\n    - **Time by Project**: Bar chart showing project time allocation\n\n### Export/Import Data\n\n**Export**\n\n1. Click the \"Export\" button in the sidebar\n2. JSON file downloads with timestamp (e.g.,\n   `gtd-backup-2025-01-06-14-30-45.json`)\n3. Save the file somewhere safe\n\n**Import**\n\n1. Click the \"Import\" button in the sidebar\n2. Select your backup JSON file\n3. Data is merged with your existing data\n4. All tasks, projects, and contexts are restored\n\n### Using Task Dependencies\n\nCreate workflows where tasks automatically become actionable when others\ncomplete:\n\n1. Create Task A: \"Design mockups\" (Next Actions)\n2. Create Task B: \"Get approval\" (Waiting For)\n3. In Task B, select Task A as a dependency\n4. When Task A is completed, Task B automatically moves to Next Actions!\n\nPerfect for:\n\n- Multi-step processes\n- Approval workflows\n- Sequential tasks\n- Team dependencies\n\n### Creating Recurring Tasks\n\nAutomate repetitive tasks by setting them to recur:\n\n1. Create or edit a task\n2. Set a recurrence interval:\n    - **Daily** - Tasks you do every day (e.g., \"Check email\")\n    - **Weekly** - Weekly routines (e.g., \"Team standup\")\n    - **Monthly** - Monthly tasks (e.g., \"Pay bills\")\n    - **Yearly** - Annual tasks (e.g., \"Performance review\")\n3. Optionally set a recurrence end date\n4. Save the task\n5. When you complete the task, a new instance is automatically created with the\n   next due date\n\n**Features:**\n\n- Tasks maintain all properties (contexts, project, energy, time, notes,\n  subtasks)\n- Optional end dates to stop recurrence after a certain date\n- Visual indicator shows recurrence interval (↻ Daily, etc.)\n- Based on task's due date, or current date if no due date set\n\nPerfect for:\n\n- Daily habits and routines\n- Weekly meetings and reports\n- Monthly bills and reviews\n- Annual maintenance tasks\n\n### Working with Contexts\n\n**About Contexts:**\n\n- All contexts must start with `@` symbol (e.g., `@home`, `@work`)\n- The `@` is automatically added if you forget it\n- Contexts help you organize tasks by situation/location\n\n**Default Contexts:**\n\n- `@home` - Tasks to do at home\n- `@work` - Work-related tasks\n- `@personal` - Personal tasks\n- `@computer` - Tasks requiring a computer\n- `@phone` - Tasks requiring a phone\n- `@errand` - Tasks requiring going out\n\n**Creating Custom Contexts:**\n\n1. Click the green \"Create Context\" button in the task form\n2. Enter context name (e.g., \"urgent\" or \"@shopping\")\n3. The `@` is added automatically if needed\n4. Click \"Create Context\"\n5. The context appears as a clickable button\n\n**Deleting Contexts:**\n\n1. Click the × button on any custom context\n2. Confirm deletion\n3. Context is removed from ALL tasks and projects\n\n### Using Task Starring/Pinning\n\n**About Starred Tasks:**\n\n- Star important tasks to keep them at the top of your lists\n- Starred tasks always appear first, regardless of other sort criteria\n- Perfect for high-priority items or tasks you want to focus on today\n\n**Starring Tasks:**\n\n1. Click the star icon on any task card\n2. The star turns gold when starred\n3. Starred tasks automatically move to the top of your list\n4. Click again to unstar\n\n**Use Cases:**\n\n- Today's must-do items\n- High-priority tasks\n- Tasks waiting for attention\n- Quick bookmarking for later review\n\n### Using Task Templates\n\n**About Templates:**\n\n- Create reusable task templates for repetitive workflows\n- Templates save time on recurring tasks and processes\n- Include all task properties: title, description, contexts, energy, time,\n  notes, and subtasks\n\n**Creating Templates:**\n\n1. Click \"Templates\" in the sidebar\n2. Click \"Create Template\"\n3. Fill in the template details:\n    - Title and description\n    - Energy level and time estimate\n    - Category (General, Work, Personal, Meeting, Checklist)\n    - Contexts\n    - Notes (instructions, reference info)\n    - Subtasks/checklist items\n4. Click \"Save Template\"\n\n**Using Templates:**\n\n1. Click \"Templates\" in the sidebar\n2. Find your template by category\n3. Click \"Create Task\" on the template card\n4. A new task is created with all the template's properties\n5. Edit the task as needed\n\n**Template Categories:**\n\n- **General** - Multipurpose templates\n- **Work** - Professional workflows (reports, reviews)\n- **Personal** - Personal routines and habits\n- **Meeting** - Meeting preparation and follow-up\n- **Checklist** - Reusable checklists and procedures\n\n**Perfect for:**\n\n- Weekly status reports\n- Meeting preparation checklists\n- Monthly bill payments\n- Code review processes\n- Project kickoff tasks\n- Daily routine checklists\n\n### Using Daily Review Mode\n\n**About Daily Review:**\n\n- Quick daily workflow to review your tasks and plan your day\n- Time-based greeting (Morning/Afternoon/Evening)\n- Shows urgent tasks, starred items, and inbox items\n- Much lighter than the Weekly Review - takes 2-5 minutes\n\n**Starting Daily Review:**\n\n1. Click the sun icon (Daily Review) in the header\n2. Review the overview section with counts for:\n    - Tasks due today and overdue\n    - Starred tasks\n    - Inbox items to process\n3. Use quick actions to:\n    - Quick capture new tasks\n    - Process your inbox\n    - Review next actions\n    - Use a template\n4. Complete tasks directly from the review\n5. Click on any task to edit it\n\n**Daily Review Sections:**\n\n- **Tasks Due Today \u0026 Overdue** - Urgent items that need attention\n    - Shows overdue tasks in red with warning\n    - Complete tasks with one click\n    - Click task to edit details\n- **Starred Tasks** - Your top 5 starred tasks\n    - Quick access to important items\n    - Great for today's priorities\n- **Inbox to Process** - Unprocessed inbox items\n    - GTD reminder to process your inbox\n    - Shows first 5 items\n    - Process: actionable? delete? delegate? defer?\n\n**When to Use:**\n\n- First thing in the morning - plan your day\n- Midday - check progress and stay focused\n- End of day - wrap up and prepare for tomorrow\n\n### Quick Edit Inline\n\n**About Inline Editing:**\n\n- Edit task titles instantly without opening the modal\n- Double-click any task title to edit\n- Saves time for quick corrections and updates\n\n**Editing Inline:**\n\n1. Double-click on any task title\n2. The title becomes an editable text field\n3. Make your changes\n4. Press Enter or click away to save\n5. Press Escape to cancel\n\n**Benefits:**\n\n- Faster than opening the full edit modal\n- Great for quick title corrections\n- Keeps you in the flow\n- Perfect for mobile users\n\n### Using Saved Filter Presets\n\n**About Saved Searches:**\n\n- Save custom filter combinations for quick access\n- Reuse frequently-used search criteria\n- Access saved searches from the advanced search panel\n\n**Saving a Search:**\n\n1. Apply your filters (context, energy, status, due date, sort)\n2. Enter a search query if needed\n3. Click \"Save Search\" button\n4. Give your search a name\n5. The search is saved for future use\n\n**Using Saved Searches:**\n\n1. Click in the search box to show advanced filters\n2. Select a saved search from the dropdown\n3. All filters are applied automatically\n4. Delete saved searches with the trash button\n\n**Perfect for:**\n\n- \"High priority @work tasks due this week\"\n- \"Phone calls to make\"\n- \"Low energy tasks for afternoon\"\n- \"Overdue inbox items\"\n- \"Tasks by project\"\n\n### Mobile Usage\n\n**Mobile-Optimized Features:**\n\n- **Touch-Friendly Interface** - All buttons are 44px minimum for easy tapping\n- **Full-Screen Modals** - Edit forms take full screen on mobile devices\n- **Responsive Design** - Layout adapts to screen size\n- **Icon-Only Buttons** - Buttons show icons only on small screens\n- **Quick Capture** - Floating + button works from any view\n- **Swipe \u0026 Tap** - Natural mobile interactions\n\n**Mobile Tips:**\n\n- Use Quick Capture for fast task entry\n- Double tap task titles to edit inline\n- Use daily review to plan your day on the go\n- Templates save time on mobile entry\n- Star important tasks for quick access\n- Portrait mode works best for task lists\n\n**Mobile-Specific Optimizations:**\n\n- No accidental zoom on focus\n- Large touch targets throughout\n- Simplified button layouts\n- Touch-optimized form inputs\n- Full-screen task editing\n\n### Viewing Project Dependencies (Gantt Chart)\n\nVisualize task relationships within a project:\n\n1. Go to \"Projects\" in the sidebar\n2. Click on a project to view its tasks\n3. Click the \"Gantt Chart\" button\n4. See tasks organized by dependency level with arrows showing relationships\n\n**Features:**\n\n- Tasks with unmet dependencies show as \"Waiting\" (orange)\n- Tasks ready to start show as \"Next\" (blue)\n- Completed tasks show as \"Completed\" (green)\n- Arrows indicate task dependencies\n- Dependencies only work within the same project\n\n### Understanding Task Status\n\n| Status            | Description        | When to Use                        |\n| ----------------- | ------------------ | ---------------------------------- |\n| **Inbox**         | Unprocessed items  | Initial capture, process later     |\n| **Next Actions**  | Actionable now     | Physical, visible tasks you can do |\n| **Waiting For**   | Blocked externally | Waiting on someone/something else  |\n| **Someday/Maybe** | Not actionable now | Future ideas, maybe later          |\n| **Completed**     | Done               | Finished tasks (archive)           |\n\n### Date Management\n\n**Due Dates**\n\n- Set deadlines for time-sensitive tasks\n- Overdue tasks show with red highlighting\n- \"Today\" appears for tasks due today\n- Calendar view shows all tasks by due date\n\n**Defer Dates**\n\n- Hide tasks until they become relevant\n- Great for future tasks you don't want to see yet\n- Tasks appear in Next Actions when defer date arrives\n\n### Keyboard Shortcuts\n\n**Global Shortcuts**\n\n- `Alt+N` - Open global quick capture overlay (works from anywhere)\n- `Ctrl+Z` - Undo last action\n- `Ctrl+Y` / `Ctrl+Shift+Z` - Redo action\n- `Escape` - Close modals, cancel quick capture\n\n**Quick Capture**\n\n- `Enter` - Submit task\n- `Escape` - Close quick capture panel\n- `T` - Browse templates (in global quick capture overlay)\n\n### Task Dependencies Visualization\n\n**Overview** Visualize task relationships with multiple views to understand\nproject dependencies and identify bottlenecks.\n\n**Using Dependencies Visualization**\n\n1. Click the graph icon in the header to open the Dependencies modal\n2. Choose from three visualization views:\n    - **Graph View**: Visual tree layout with curved connection lines showing\n      dependencies\n    - **Dependency Chains**: Sequential lists showing A→B→C task relationships\n    - **Critical Path**: Timeline showing the longest chain determining project\n      duration\n3. Statistics show: total tasks, with dependencies, blocked tasks,\n   ready-to-start\n4. Filter by project to see specific dependency relationships\n5. Click any task node to edit it directly\n\n**Creating Task Dependencies**\n\n1. Edit a task and scroll to \"Dependencies\"\n2. Select tasks that must complete before this task can start\n3. Tasks show as \"Blocked\" until dependencies are met\n4. When dependencies complete, tasks automatically become actionable\n\n**Use Cases**\n\n- Multi-step projects where tasks must be completed in order\n- Approval workflows (design → approval → development)\n- Prerequisite tracking (learn basics → advanced topics)\n- Identifying project bottlenecks and critical path\n\n### Productivity Heatmap\n\n**Overview** GitHub-style contribution calendar showing your task completion\nactivity over the last 365 days.\n\n**Using the Heatmap**\n\n1. Click the calendar icon in the header to view your productivity heatmap\n2. See visual representation of completed tasks per day\n3. Color intensity shows completion volume (5 levels)\n4. View statistics: total completed, best day, average per day, current streak\n5. Hover over any day to see exact count and date\n\n**Features**\n\n- 365-day activity history\n- Color-coded intensity (gray → green scale)\n- Streak tracking for consecutive days\n- Month and day labels for navigation\n- Statistics dashboard with key metrics\n\n**Benefits**\n\n- Visual motivation through activity tracking\n- Identify productivity patterns\n- Track streak consistency\n- Celebrate progress milestones\n\n### Global Quick Capture (Alt+N)\n\n**Overview** Instantly capture tasks from anywhere in the application using a\nglobal hotkey.\n\n**Using Global Quick Capture**\n\n1. Press `Alt+N` from any view to open the capture overlay\n2. Type your task with optional syntax:\n    - `@context` - Add contexts\n    - `!high/!medium/!low` - Set energy level\n    - `#project` - Assign to project\n    - `today/tomorrow/in X days` - Set due date\n3. Press `Enter` to save or `Escape` to cancel\n4. Press `T` to browse and select templates\n\n**Example Entries**\n\n- \"Call mom @phone\" - Adds @phone context\n- \"Finish report !high @work today\" - High energy, @work context, due today\n- \"Review code #project-alpha !medium\" - Assigns to project-alpha\n- \"Weekly planning in 7 days\" - Sets due date 7 days from now\n\n**Benefits**\n\n- Capture ideas without interrupting your flow\n- Fast natural language input\n- Works from any screen or view\n- Template integration for common tasks\n\n### Focus Timer Auto-Integration\n\n**Overview** The Pomodoro timer now integrates seamlessly with Focus Mode for\nautomatic time tracking.\n\n**Auto-Integration Features**\n\n- **Auto-Start**: Timer starts automatically when entering Focus Mode\n- **Auto-Track**: Time spent on focused task is tracked automatically\n- **Auto-Stop**: Timer stops automatically when completing a task\n- Toast notifications show time tracked when exiting focus mode\n\n**Using Enhanced Focus Mode**\n\n1. Click the bullseye icon (Focus Mode) in the header\n2. Select a task from smart suggestions\n3. Timer starts automatically (25-minute Pomodoro)\n4. Work on the task distraction-free\n5. Click \"Complete Task\" to auto-stop timer and track time\n6. Toast shows how much time was tracked\n\n**Benefits**\n\n- No manual timer management needed\n- Accurate time tracking without effort\n- Seamless workflow from focus to completion\n- Better focus with automatic sessions\n\n### Task Priority Scoring\n\n**Overview** Automatic 0-100 priority scores help you focus on what matters\nmost.\n\n**Scoring Factors**\n\n- Due date urgency (overdue +25, due today +20, due tomorrow +15)\n- Starred tasks (+15)\n- Task status (Next Actions +10)\n- Dependencies (ready +10, blocked -10)\n- Energy vs time match (quick high-energy +8)\n- Time estimate (quick tasks +5)\n- Project priority (+5 for active projects)\n- Defer date penalty (-20 if deferred)\n- Task age (old tasks +7)\n\n**Priority Levels**\n\n- **80-100 (Red)**: Urgent - Requires immediate attention\n- **60-79 (Orange)**: High - Important tasks\n- **40-59 (Yellow)**: Medium - Normal priority\n- **20-39 (Blue)**: Low - Can wait\n- **0-19 (Gray)**: Very Low - Backlog\n\n**Viewing Priority Scores**\n\n- Color-coded badges appear on all incomplete tasks\n- Hover to see priority label\n- Tasks auto-sort by priority (starred first, then by score)\n- Helps you focus on high-impact tasks\n\n### Archive System\n\n**Overview** Keep your active workspace clean by archiving completed tasks while\npreserving history.\n\n**Using the Archive**\n\n1. Click the Archive icon in the sidebar\n2. View all archived tasks with metadata\n3. **Auto-Archive**: Archive tasks completed more than 30 days ago\n4. Search and filter by project\n5. Restore archived tasks with one click\n6. Delete permanently if needed\n\n**Archive Statistics**\n\n- Total number of archived tasks\n- Original project and status preserved\n- Archive date recorded\n- Searchable full-text\n\n**Benefits**\n\n- Reduces clutter in active views\n- Preserves task history\n- Fast access to old tasks if needed\n- Maintains performance with large datasets\n\n### Quick Actions Context Menu\n\n**Overview** Right-click on any task for instant access to common operations.\n\n**Using Context Menu**\n\n- **Desktop**: Right-click on any task\n- **Mobile**: Long-press (500ms) on any task\n- Quick actions: edit, duplicate, toggle star, set status, set energy, move to\n  project, add/remove context\n- Complete or delete tasks directly\n- Much faster than opening full edit modal\n\n### Smart Date Suggestions\n\n**Overview** Type natural language in date fields and see intelligent\nsuggestions.\n\n**Supported Phrases**\n\n- \"in 3 days\" - Relative days\n- \"tomorrow\" - Next day\n- \"next week\" - 7 days from now\n- \"end of month\" - Last day of month\n- \"today\" - Current date\n\n**Using Smart Suggestions**\n\n1. Click in a due date or defer date field\n2. Start typing a natural language phrase\n3. See suggestions appear below the field\n4. Click any suggestion to auto-fill\n\n### Task Countdown Badges\n\n**Overview** Visual indicators show days remaining on tasks with due dates.\n\n**Badge Colors**\n\n- **Red (≤2 days)**: Urgent deadline approaching\n- **Orange (3-5 days)**: Due soon\n- **Yellow (6-7 days)**: This week\n\n**Viewing Countdowns**\n\n- Appears on tasks due within 14 days\n- Color coding for quick visual scanning\n- Helps prioritize time-sensitive work\n\n### Enhanced Analytics\n\n**Overview** Productivity dashboard with trends and insights about your task\nmanagement.\n\n**Analytics Sections**\n\n- **Last 7 Days**: Bar chart showing tasks completed each day\n- **Task Lifecycle**: Average time from creation to completion\n- **Completion Velocity**: Trend indicator (up/down/stable)\n- **Context Distribution**: Tasks by context\n- **Project Time**: Time spent per project\n\n**Using Analytics**\n\n1. Click Dashboard button (chart icon) in header\n2. Review productivity trends\n3. Identify patterns in your work habits\n4. Make data-driven decisions about task management\n\n## Data Storage\n\n### Local Storage\n\n- All data is stored in your browser's localStorage\n- Your tasks stay private on your device\n- Works offline\n- No account or internet connection required\n\n### Backup \u0026 Export\n\nTo back up your data:\n\n1. Click the \"Export\" button in the sidebar footer\n2. A timestamped JSON file downloads automatically\n3. Store the backup file in a safe location\n\nTo restore:\n\n1. Click the \"Import\" button in the sidebar footer\n2. Select your backup JSON file\n3. Data is merged with existing data\n4. Refresh to see restored items\n\n### Clearing Data\n\n- Clearing browser data will delete all tasks\n- Export important data regularly\n- Use browser sync to sync data across devices\n- PWA offline storage available\n\n## Development\n\n### Project Structure\n\n```\nGTD-web/\n├── index.html          # Main HTML file\n├── css/\n│   └── styles.css      # Application styles\n├── js/\n│   ├── app.js          # Main application logic\n│   ├── models.js       # Task, Project, Reference models\n│   ├── storage.js      # LocalStorage wrapper\n│   ├── constants.js    # Configuration constants\n│   ├── dom-utils.js    # DOM manipulation utilities\n│   └── nlp-parser.js   # Natural language parser\n├── __tests__/\n│   ├── storage.test.js # Storage layer tests\n│   └── models.test.js  # Model tests\n├── manifest.json       # PWA manifest\n├── service-worker.js   # PWA service worker\n├── package.json        # Dependencies and scripts\n└── README.md          # This file\n```\n\n### Adding New Features\n\n1. **Models** - Add new properties to classes in `js/models.js`\n2. **Storage** - Update persistence in `js/storage.js`\n3. **UI** - Modify `js/app.js` for user interactions\n4. **Styles** - Add CSS in `css/styles.css`\n5. **Tests** - Write tests in `__tests__`\n\n### Code Style\n\n- ES6+ JavaScript modules\n- Async/await for asynchronous operations\n- Clear naming and comments\n- Comprehensive error handling\n\n## Troubleshooting\n\n### Tasks not appearing\n\n- Check browser console for errors (F12)\n- Verify data in localStorage\n- Try refreshing the page\n- Check if filters are hiding tasks\n\n### Contexts not saving\n\n- Check if context name conflicts with existing contexts (case-insensitive)\n- Look at browser console for error messages\n- Verify localStorage has available space\n\n### App stuck on \"Loading...\"\n\n- Open browser DevTools console\n- Check for JavaScript errors\n- Try clearing cache and refreshing\n\n### Recurring tasks not creating new instances\n\n- Ensure the task has a recurrence interval set\n- Check if recurrence end date has passed\n- Verify the task is actually being completed (checkbox checked)\n- Look for browser console errors\n\n### Dark mode not persisting\n\n- Check if localStorage is enabled\n- Clear browser cache and cookies\n- Verify system preference settings\n\n## Browser Compatibility\n\n- Chrome/Edge (recommended)\n- Firefox\n- Safari\n- Opera\n\nRequires a modern browser with ES6 module support.\n\n## License\n\nMIT License - feel free to use this application for personal or commercial\npurposes.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests.\n\n## Credits\n\nCreated as a full-featured GTD implementation following David Allen's Getting\nThings Done methodology.\n\n## Recent Updates\n\n### Version 2.2.0 (Current) - Productivity Power Release\n\n#### Major New Features\n\n- ✨ **Task Dependencies Visualization** - Graph view, dependency chains, and\n  critical path analysis\n- ✨ **Productivity Heatmap Calendar** - GitHub-style contribution calendar\n  showing 365 days of activity\n- ✨ **Global Quick Capture (Alt+N)** - Instant task capture from anywhere with\n  natural language parsing\n- ✨ **Focus Timer Auto-Integration** - Auto-start, auto-track, auto-stop for\n  seamless Pomodoro workflow\n- ✨ **Task Priority Scoring** - Automatic 0-100 scores based on multiple\n  intelligent factors\n\n#### Additional Enhancements\n\n- ✨ **Archive System** - Auto-archive completed tasks to reduce clutter\n- ✨ **Quick Actions Context Menu** - Right-click tasks for instant operations\n- ✨ **Smart Date Suggestions** - Natural language date parsing (in 3 days,\n  tomorrow, next week)\n- ✨ **Task Countdown Badges** - Visual days-remaining indicators on due tasks\n- ✨ **Enhanced Analytics** - Productivity trends, task lifecycle, completion\n  velocity\n- ✨ **Bulk Operations** - Set status, energy, context, due dates on multiple\n  tasks at once\n\n#### Improvements\n\n- 🔧 Faster task operations with context menu\n- 🔧 Better productivity insights with enhanced analytics\n- 🔧 Improved focus mode with automatic timer management\n- 🔧 Cleaner workspace with archive system\n- 🔧 Smarter prioritization with automatic scoring\n- 🔧 Better task dependency visualization\n- 🔧 Enhanced mobile long-press for context menu\n\n#### UX Improvements\n\n- ⚡ Instant task capture with global hotkey\n- ⚡ One-click access to common task operations\n- ⚡ Visual productivity motivation with heatmap\n- ⚡ Automatic time tracking in focus mode\n- ⚡ Data-driven prioritization\n- ⚡ Reduced cognitive load with auto-scoring\n\n### Version 2.1.0 - Productivity Enhancements Release\n\n#### New Features\n\n- ✨ **Task Starring/Pinning** - Mark important tasks with stars to keep them at\n  the top of your lists\n- ✨ **Task Templates** - Create reusable task templates for repetitive\n  workflows (weekly reports, meeting notes, checklists)\n- ✨ **Daily Review Mode** - Quick daily workflow with time-based greeting,\n  urgent tasks overview, and quick actions\n- ✨ **Quick Edit Inline** - Double-click any task title to edit it instantly\n  without opening a modal\n- ✨ **Enhanced Mobile Support** - Touch-optimized interface with 44px touch\n  targets, full-screen modals, and responsive design\n- ✨ **Saved Filter Presets** - Save and load custom filter combinations for\n  frequently-used searches (previously implemented)\n\n#### Improvements\n\n- 🔧 Mobile browser experience significantly improved\n- 🔧 Touch targets enlarged for mobile (44px minimum)\n- 🔧 Full-screen modals on mobile devices\n- 🔧 Icon-only buttons on small screens\n- 🔧 Better responsive layout across all screen sizes\n- 🔧 No accidental zoom on form focus\n- 🔧 Starred tasks always appear first in lists\n- 🔧 Templates organized by category for easy access\n- 🔧 Daily review shows context-aware greeting\n- 🔧 Inline editing saves time on quick updates\n\n#### UX Improvements\n\n- ⚡ Faster task editing with inline mode\n- ⚡ Better mobile touch interactions\n- ⚡ Streamlined daily workflow with daily review\n- ⚡ Quick access to important tasks via starring\n- ⚡ Time savings with reusable templates\n\n### Version 2.0.0 - Major Feature Release\n\n#### New Features\n\n- ✨ **Dark Mode** - Toggle between light and dark themes with system preference\n  detection\n- ✨ **Calendar View** - Visual calendar displaying tasks by due date with month\n  navigation\n- ✨ **Focus Mode** - Full-screen single-task focus with integrated Pomodoro\n  timer (25/5 min intervals)\n- ✨ **Task Notes** - Add detailed notes and progress updates to any task\n- ✨ **Subtasks \u0026 Checklists** - Break down tasks into manageable steps with\n  progress tracking\n- ✨ **Quick Capture Widget** - Floating button for instant task capture from\n  any view\n- ✨ **Undo/Redo System** - Full history tracking (50 states) with keyboard\n  shortcuts\n- ✨ **Advanced Sorting** - Sort tasks by due date, created date, time estimate,\n  or title\n- ✨ **Time Analytics Dashboard** - Visualize time spent by context and project\n- ✨ **Project Health Indicators** - Progress bars and health status for all\n  projects\n- ✨ **Export/Import** - Backup and restore data as timestamped JSON files\n- ✨ **PWA Support** - Install as Progressive Web App for offline use\n- ✨ **Natural Language Parsing** - Smart task entry with context/energy/time\n  extraction\n- ✨ **Smart Suggestions** - AI-powered task recommendations based on usage\n  patterns\n- ✨ **Weekly Review** - Guided weekly review workflow with cleanup tools\n- ✨ **Dashboard** - Productivity analytics with trends and insights\n- ✨ **Advanced Search** - Multi-criteria filtering with saved searches\n\n#### Improvements\n\n- 🔧 Enhanced project creation (direct creation or task conversion)\n- 🔧 Better drag-and-drop support throughout the app\n- 🔧 Improved task card layout with more information\n- 🔧 Enhanced time tracking with visual indicators\n- 🔧 Bulk selection and operations for tasks\n- 🔧 Better mobile responsiveness\n- 🔧 Performance optimizations for large task lists\n- 🔧 Improved accessibility and keyboard navigation\n\n#### Bug Fixes\n\n- 🐛 Fixed project type conversion (tasks to projects and vice versa)\n- 🐛 Fixed context handling throughout the app\n- 🐛 Fixed dependency tracking edge cases\n- 🐛 Fixed recurring task creation issues\n- 🐛 Fixed time tracking display bugs\n- 🐛 Fixed filter interaction bugs\n\n## Roadmap\n\nFuture enhancements being considered:\n\n- [ ] Cloud sync options\n- [ ] Mobile native apps\n- [ ] Collaboration features\n- [ ] Email integration (email-to-inbox)\n- [ ] Calendar app integration (Google Calendar, Outlook)\n- [ ] Advanced reporting templates\n- [ ] Habit tracking separate from tasks\n- [ ] Goals and areas of focus\n- [ ] Voice input for mobile\n- [ ] Task attachments and files\n\n## Support\n\nFor issues, questions, or suggestions, please open an issue on the project\nrepository.\n\n---\n\n**Stay organized. Get things done.** ✅\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonch1962%2Fgtd-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmonch1962%2Fgtd-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonch1962%2Fgtd-web/lists"}