# Home Page

The central hub for managing all your flows, organized with folders, favorites, and quick access to recent activity.

## Overview

The home page is where you manage all your flows. When you launch Watchflows, this is the first screen you see. It displays a Your Flows header with a count badge showing the total number of flows in the current view.

From here you can create new flows, browse existing ones, search by name, star favorites, switch between card and table views, and access active triggers and recent activity from the sidebar.

## Card View

Card view is the default layout. Each flow appears as a glass-material card with a subtle frosted backdrop. Cards display the following information at a glance:

- Icon — A visual identifier for the flow, shown at the top of the card.
- Name — The flow's title, displayed prominently below the icon.
- Status badge — Shows whether the flow is active, inactive, or has errors. Color-coded for quick scanning.
- Node count — The number of nodes in the flow's canvas.
- Run count — How many times the flow has executed.
- Last updated — A relative timestamp showing when the flow was last modified.

Hover over a card to reveal the star toggle in the top-right corner. Click it to add the flow to your favorites. Click the card itself to open the flow on the canvas.

## Table View

Switch to table view using the view toggle in the toolbar. Table view presents your flows in a compact, sortable list with the following columns:

Column | Description
--- | ---
Name | Flow title with icon. Click to open the flow.
Status | Active, inactive, or error state shown as a colored badge.
Nodes | Total number of nodes in the flow.
Runs | Lifetime execution count for the flow.
Updated | Relative timestamp of the last modification.

Click any column header to sort by that column. Click again to reverse the sort direction. The current sort column and direction are indicated by an arrow icon in the header.

## Favorites Section

Starred flows appear in a pinned Favorites section at the top of both card view and table view. This gives you instant access to the flows you use most often without scrolling.

- In card view — Hover over a card to reveal the star icon in the top-right corner. Click it to toggle the favorite state.
- In table view — A yellow star appears in the first column for favorited flows. Click it to unfavorite.
- The Favorites section only appears when you have at least one starred flow. It collapses automatically when all stars are removed.

## Search

An inline search field sits next to the Your Flows header. Type to filter flows by name across all folders. The results update in real time as you type, narrowing down both the card grid and the table rows.

Search is case-insensitive and matches any substring of the flow name. The count badge updates to reflect the number of matching flows. Clear the search field to return to the full list.

## Toolbar

The toolbar runs across the top of the home page and contains the primary controls for managing your workspace:

- Search field — Quick access to the flow search. Filters the current view by name.
- App title — Centered title showing the app name.
- New Flow button — Creates a new blank flow and opens it on the canvas immediately.
- All Triggers toggle — Pauses or resumes all armed flows at once. Turning it off suspends every active trigger without disarming individual flows; turning it on (or arming any flow from its canvas) re-arms all enabled flows.
- View mode switcher — Two icons that toggle between card view and table view. The active mode is highlighted.

## Sidebar

The home page sidebar provides quick navigation and contextual information about your workspace. It contains three main sections:

### Quick Actions

A shortcut to create a new flow without using the toolbar. Click New Flow to get started immediately.

### Active Triggers

Lists all triggers that are currently armed and listening for events. Each trigger is shown with its type, the flow it belongs to, and a folder color dot indicating which folder the flow is organized into. This gives you a quick overview of what automations are running without opening individual flows.

### Recent Activity

Displays recent execution history grouped by workflow. Each entry shows the flow name, the trigger that fired, and the outcome (success or failure). This is a condensed view of the full execution timeline available in each flow's canvas.