Features
- Task Management: Create, check, and delete todos
- Drag & Drop: Reorder tasks by priority
- Auto-Clear: Optional automatic cleanup of old tasks
- Task Reminders: Get notifications about pending todos
- Timestamp Tracking: Automatically records creation time
- Quick Input: Fast task entry with keyboard support
Setup
No integration required—start adding tasks immediately!Adding Tasks
Usage
Task Display
Each todo shows:- Checkbox: Click to mark complete/incomplete
- Task Text: Description of the todo
- Delete Button: Trash icon (appears on hover)
Completing Tasks
Click anywhere on a task or its checkbox to:- Mark it as complete (strikethrough text)
- Uncheck to mark as incomplete
- Toggle state with each click
Deleting Tasks
Reordering Tasks
Drag and drop to prioritize:- Click and hold on a task
- Drag it up or down
- Drop it in the new position
- Order saves automatically
Clearing All Tasks
Click the eraser icon in the widget header to delete all todos at once.Configuration Options
Todo Reminders
Enable in your user settings:- Get notifications when you have pending todos
- Shows count of incomplete tasks
- Triggers once per session
- Helps you stay on track
Auto-Delete Old Todos
Enable in settings to automatically clear tasks from previous days:- Runs when you load the dashboard
- Removes todos created before today
- Keeps only today’s tasks
- Helps maintain a fresh daily task list
Auto-delete only triggers if you have pending todos from previous days. It won’t trigger if all tasks are from today.
Task Tracking
Each task stores:- ID: Unique identifier
- Text: Task description
- Checked: Completion status (true/false)
- Created At: ISO timestamp of creation
- Determining if tasks are from previous days
- Auto-delete functionality
- Future features (sorting by age, etc.)
Keyboard Shortcuts
- Enter: Submit new task
- Click: Toggle task completion
Drag & Drop Details
Mouse Control
- Activation: Click and drag (10px threshold)
- Visual Feedback: Dragged task becomes semi-transparent
- Vertical Only: Tasks move up and down only
Touch Control
- Activation: Long-press for 250ms
- Tolerance: 5px movement tolerance
- Mobile-Optimized: Smooth experience on all devices
Best Practices
Start Each Day Fresh: Clear yesterday’s completed tasks Prioritize: Use drag-and-drop to put important tasks at the top Be Specific: Write clear, actionable task descriptions Check Regularly: Review and update your list throughout the day Use Reminders: Enable notifications to stay on top of pending tasksStorage
Todos are stored:- In widget configuration
- Saved automatically on every change
- Synced with your Forge account
- Persisted across sessions and devices
Troubleshooting
Common Issues
Can’t add tasks: Make sure you’ve typed text in the input field. Drag not working: Click and hold (or long-press) before starting to drag. Auto-delete not triggering: Check that the setting is enabled and you have old tasks. Tasks disappeared: If auto-delete is enabled, tasks from previous days are automatically removed.Notifications
Todo reminder notifications show:- Number of pending (unchecked) tasks
- Example: “You have 5 pending todos for today!”
- Triggers once when you load the dashboard
- Only if todo reminders are enabled in settings
Integration with Settings
The widget respects these user settings:- todoReminder: Enable/disable task notifications
- deleteTodos: Enable/disable auto-cleanup of old tasks
Widget Sizes
- Desktop: 1 column × 2 rows
- Tablet: 1 column × 2 rows
- Mobile: 1 column × 1 row
The Todo widget is perfect for daily task management, quick to-do lists, shopping lists, or any checklist-style workflow.