> ## Documentation Index
> Fetch the complete documentation index at: https://docs.8space.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard

> Monitor project health with execution metrics, completion trends, and team workload insights

The Dashboard provides a high-level overview of your project's health and progress. It surfaces key metrics in a visual format inspired by project planning tools, helping you spot issues, track delivery pace, and understand team capacity at a glance.

## Dashboard Layout

The Dashboard is organized into three sections:

1. **KPI Cards**: Four key metrics displayed as prominent cards at the top
2. **Trend Charts**: Visual representations of progress over time
3. **Status Breakdown**: Current distribution of tasks across workflow stages

## Time Window Selection

Control the data range shown in the dashboard using the toggle in the top-right corner:

<Tabs>
  <Tab title="7 Days">
    Shows metrics and trends for the last week, ideal for:

    * Sprint reviews
    * Short-term velocity tracking
    * Immediate team capacity
  </Tab>

  <Tab title="14 Days">
    Shows metrics and trends for the last two weeks (default), ideal for:

    * Bi-weekly planning cycles
    * Broader trend analysis
    * Release planning
  </Tab>
</Tabs>

All metrics and charts on the dashboard update automatically when you change the time window.

## Key Performance Indicators (KPIs)

Four metric cards provide instant insight into project health:

<CardGroup cols={2}>
  <Card title="Overdue Tasks" icon="triangle-exclamation" color="#ef4444">
    Number of tasks that are past their due date and not yet completed. High numbers indicate scheduling issues or blocked work.

    **Ideal state**: Zero or very few overdue tasks
  </Card>

  <Card title="Due This Week" icon="calendar-check" color="#3b82f6">
    Tasks scheduled to be completed within the next 7 days. Helps you plan immediate work capacity.

    **Use for**: Sprint planning and immediate priorities
  </Card>

  <Card title="In Progress" icon="gauge" color="#f59e0b">
    Tasks currently in the "In Progress" workflow stage. Indicates active work and team focus.

    **Monitor for**: Work-in-progress limits and flow
  </Card>

  <Card title="Done" icon="check-check" color="#10b981">
    Total completed tasks in the "Done" workflow stage. Represents delivered value.

    **Track for**: Velocity and throughput metrics
  </Card>
</CardGroup>

Each card includes:

* A descriptive icon color-coded for quick scanning
* The metric value prominently displayed
* A hint explaining what the metric represents

## Completion Trend

The completion trend chart visualizes how many tasks were completed each day within the selected time window.

### Chart Features

* **Horizontal bars**: Each day shows a bar representing completed task count
* **Date labels**: Displayed as MM-DD format on the left
* **Count values**: Numeric count shown on the right of each bar
* **Dynamic scaling**: Bars scale relative to the highest daily count in the period
* **Minimum bar width**: Even days with just one completion show a visible bar

<Tip>
  Consistent daily completion (steady bar heights) indicates healthy flow. Large spikes often indicate batch delivery at deadlines.
</Tip>

### Interpreting the Trend

<AccordionGroup>
  <Accordion title="Steady Progress" icon="chart-line">
    Bars of similar height across days indicate consistent delivery pace and good flow.
  </Accordion>

  <Accordion title="Spikes and Valleys" icon="wave-pulse">
    Large variations suggest batch delivery patterns, possibly indicating:

    * Work building up and releasing in batches
    * Sprint-end rushes
    * Blocked work that suddenly clears
  </Accordion>

  <Accordion title="Empty Days" icon="calendar-xmark">
    Days with no completions (zero bar) might indicate:

    * Weekends or holidays
    * Focus on starting new work vs. finishing existing work
    * All team members on non-tracked activities
  </Accordion>
</AccordionGroup>

## Workload by Assignee

This widget shows the distribution of active tasks across team members:

* **Name**: Team member's display name
* **Active count**: Number of tasks currently assigned to them (not in "Done")
* **Sorted**: Typically ordered by active count descending

<Card title="Workload Balance" icon="scale-balanced">
  Use this widget to:

  * Identify team members who are overloaded
  * Spot uneven work distribution
  * Plan task reassignments
  * See who has capacity for new work
</Card>

### Empty State

If no team members have active tasks, you'll see: "No active assignee load."

This might occur when:

* All tasks are unassigned
* All tasks are already completed
* You're starting a new project

## Tasks by Status

The bottom section breaks down all tasks by their workflow stage:

* **To Do**: Tasks ready to start but not yet begun
* **In Progress**: Tasks currently being worked on
* **Done**: Completed tasks
* **Backlog**: Tasks planned but not yet scheduled

Each status shows:

* Uppercase label for quick scanning
* Large, prominent count
* Bordered card for visual separation

<Info>
  If you have custom workflow columns, they may also appear in this breakdown depending on their configured "kind" mapping.
</Info>

## Refresh Behavior

The Dashboard automatically refetches data when:

* You switch between projects
* You change the time window (7 days ↔ 14 days)
* You return to the Dashboard after updating tasks in other views

<Note>
  If metrics seem outdated after making changes elsewhere, simply navigate away and back to the Dashboard to trigger a refresh.
</Note>

## Viewer Mode

All users can view the Dashboard regardless of role. Viewers see the same metrics as editors and owners, making it ideal for:

* Sharing progress with stakeholders
* Team standups and reviews
* Executive reporting
* Client visibility

## Using the Dashboard Effectively

<Steps>
  <Step title="Daily standup check">
    Start your day by reviewing overdue tasks and workload balance. Address any red flags before they grow.
  </Step>

  <Step title="Weekly review">
    Use the 7-day window to review completion trends and ensure steady delivery pace.
  </Step>

  <Step title="Sprint planning">
    Check "Due this week" and team workload before committing to new work.
  </Step>

  <Step title="Retrospectives">
    Use the 14-day window to spot patterns in delivery flow and identify process improvements.
  </Step>
</Steps>

## Best Practices

<CardGroup cols={2}>
  <Card title="Set Realistic Dates" icon="calendar-days">
    Accurate due dates make the "Overdue" and "Due this week" metrics meaningful and actionable.
  </Card>

  <Card title="Update Status Regularly" icon="rotate">
    Move tasks through workflow stages promptly so the Dashboard reflects current reality.
  </Card>

  <Card title="Balance Workload" icon="scale-balanced">
    Use the workload widget to redistribute tasks when imbalances emerge.
  </Card>

  <Card title="Watch the Trend" icon="chart-line">
    Aim for consistent completion rates rather than end-of-sprint rushes.
  </Card>
</CardGroup>

## Empty State

If your project has no tasks yet, the Dashboard will still render with zero values for all metrics and empty charts. This is normal for new projects.

Head to the Backlog or Board view to start adding tasks, then return to the Dashboard to see metrics appear.