Skip to content

Interface

Wylie Standage-Beier edited this page Dec 9, 2025 · 2 revisions

Interface

TaskFlow's interface is divided into distinct areas for efficient navigation.


Layout Overview

┌─────────────────────────────────────────────────────────────────┐
│ TaskFlow                                                        │ ← Header
├──────────────┬──────────────────────────────────────────────────┤
│              │                                                  │
│   Sidebar    │              Task List                           │
│              │                                                  │
│  ┌─────────┐ │  ┌─────────────────────────────────────────────┐ │
│  │ Views   │ │  │ !!!! [ ] Fix critical bug        due:today  │ │
│  │ ─────── │ │  │ !!!  [~] Implement feature       #backend   │ │
│  │ All     │ │  │ !!   [ ] Write tests             #testing   │ │
│  │ Today   │ │  │ !    [ ] Update documentation               │ │
│  │ Upcoming│ │  │      [x] Initial setup           completed  │ │
│  │ Overdue │ │  └─────────────────────────────────────────────┘ │
│  │ Calendar│ │                                                  │
│  │         │ │                                                  │
│  │ Projects│ │                                                  │
│  │ ─────── │ │                                                  │
│  │ Work    │ │                                                  │
│  │ Personal│ │                                                  │
│  └─────────┘ │                                                  │
├──────────────┴──────────────────────────────────────────────────┤
│ 5 tasks (1 completed) │ showing all │ ? for help               │ ← Footer
└─────────────────────────────────────────────────────────────────┘

Header

The top bar displays:

  • Application name
  • Current view or search query
  • Pomodoro timer (when active)

Sidebar

The left panel for navigation. Press h to focus, l to return to tasks.

Views Section

View Description
All Tasks Every task
Today Due today
Upcoming Future due dates
Overdue Past due date
Calendar Monthly view
Dashboard Statistics
Reports Analytics
Scheduled Has scheduled date
Blocked Waiting on dependencies
Untagged No tags
No Project Unassigned
Recent Modified last 7 days

Projects Section

  • Lists all projects
  • Shows task count per project
  • Select to filter tasks

Task List

The main content area showing your tasks.

Task Display Format

Priority  Status  Title                      Tags         Due Date
   │        │       │                          │              │
   ▼        ▼       ▼                          ▼              ▼
  !!!!    [ ]    Fix critical bug           #urgent        [12/15]

Priority Indicators

Symbol Priority
!!!! Urgent
!!! High
!! Medium
! Low
(blank) None

Status Symbols

Symbol Status
[ ] Todo
[~] In Progress
[!] Blocked
[x] Done
[-] Cancelled

Additional Indicators

Symbol Meaning
Recurring task
[B] Has dependencies
Has subtasks
Time tracking active

Footer / Status Bar

The bottom bar shows:

  • Task count and completed count
  • Current filter state
  • Mode indicators (search, multi-select)
  • Help reminder
  • Pomodoro status (when active)

Modal Dialogs

TaskFlow uses popups for:

  • Input dialogs - Creating/editing tasks
  • Confirmation dialogs - Delete confirmation
  • Help popup - Keybinding reference
  • Template picker - Quick task creation
  • Time log editor - Time entry management

Press Esc to close any dialog.


Navigation Keys

Key Action
h / Focus sidebar
l / Focus task list
j / Move down
k / Move up
Enter Select item
Esc Cancel/close

Mouse Support

TaskFlow supports mouse interaction for navigation and selection.

Click Actions

Click Area Action
Sidebar item Select view or project
Task in list Select task
Double-click task Enter focus mode
Calendar day Show tasks for that day
Kanban column Focus column
Eisenhower quadrant Focus quadrant
Weekly planner day Focus day
Reports tab Switch report panel

Scroll Wheel

Action Result
Scroll up Move selection up
Scroll down Move selection down

View-Specific Mouse

Calendar View

  • Click on a day to select it
  • Click on a task in the day list to select it

Kanban View

  • Click on columns to navigate between them
  • Click on tasks within a column to select

Reports View

  • Click on tabs to switch between report panels

See Also

Clone this wiki locally